PK57855: DPL REQUEST AND EXEC CICS START COMMAND THAT ARE DYNAMICALLY ROUTE, MAY RETURN A NON 0 VALUE IN DYPERRO 07/12/10 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• After application of PK55587, dynamically routed DPL and EXEC
  CICS command might return a non 0 value in DYRERROR although
  the request has completed successfully.
  Other successful function ship requests, such as file control,
  might also return a non zero response.
  

Local fix

• Remove PK55587
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users with UK31454 or               *
  *                 UK31463 applied.                             *
  ****************************************************************
  * PROBLEM DESCRIPTION: DYRERROR may contain nonzero value      *
  *                      followed successfully routed DPL        *
  *                      or EXEC CICS START request.             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A dynamically routed DPL request or EXEC CICS START may
  incorrectly return a bad response in the DYRERROR field in the
  commarea passed to the user dynamic routing program.
  
  These commands result in a CONVERSE command which is processed
  by DFHISP. PK55587 changed DFHISP to use register 4 to address
  its parameter area, however the parameter area was not correctly
  readdressed following the call to the CONVERSE routine,
  resulting in erroneous data being put into :-
  - the return code from DFHISP (ISCRQRC),
  - the Data1 & 2 portions of the exit trace from DFHISP.
  
  The unpredictable value in ISCRQRC may result in a bad response
  in DYRERROR, which in turn may result in a SYSIDERR being
  returned by the EXEC CICS LINK or EXEC CICS START command.
  
  Additional keywords
  TCATRF1 TCATRF2 ISCRQRC ISCRQSYS Reg2 Reg4
  

Problem conclusion

• UK31454 UK31463
  DFHISP has returned to using R2 to address the Input Parameter
  Area. The addressability issue has be corrected by moving
  the routine BLDCONN to a subroutine.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK32569 UK32583

Modules/Macros

•    DFHISP
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK32569

     UP07/12/25 P F712

• R500 PSY UK32583

     UP07/12/25 P F712

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.