PI81158: DFHZC6951 W AUTOINSTALL FOR TERMINAL XXXX FAILED WITH RC 5

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• After migration to CICS TS 53, user written DFHZATDX
  occasionally fails with the following error:
  
  DFHZC6951 W Autoinstall for terminal xxxx failed with RC 5
  It happens when the delete shipped is taking place.
  .
  When SIT parm DSHIPINT triggers the delete shipped terminals,
  CSMF is attached and scan for terminals to delete.
  When a terminal to be deleted is found, CRMD is attached to
  delete it.
  After the delete has been completed, the autoinstall program
  is invoked.
  DFHZATMD gets control to locate the TCTTE, write the trace entry
  and delete the shipped terminal.
  But when DFHZATDM calls the user exit (tctvaxit),
  there is an INVALID_COMMAREA_LEN.
  DFHPGLU returns a bad response/reason code. But DFHZATMD sets
  RC=5 which is the drop-through unknown cause.
  .
  DFHZATMD expects to have in the reg 9 the
  LENGTH(DELETE_SHIPPED_COMMAREA)
  and then call the user exit. But during the process we call
  trace_userexit_entry and dfhtrptm reuses Reg9.
  The length of the COMMAREA got corrupted when trace entry AP
  FC98 was issued just before calling the user URM in DFHZATMD.
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHZC6951 being issued during shipped   *
  *                      terminals deletion.                     *
  ****************************************************************
  CICS region is started up with DSHIPIDL/DSHIPINT configuration.
  DSHIPIDL/DSHIPINT triggers the delete shipped terminals and
  CRMD will be attached for it. It locates the terminals which
  are marked for deletion, and then deletes them. For each
  shipped terminal deletion, an user exit will be called.
  Register 8 is used to address the COMMAREA, and register 9 for
  its length.
  
  Before calling the user exit program, there is a call to
  another routine which reuses register 9. This means register 9
  which should contain the length of the COMMAREA has been
  changed. This causes an exception INVALID_COMMAREA_LEN during
  the user exit process with message DFHZC6951.
  

Problem conclusion

• DFHZATMD has been changed to make sure register 9 will not be
  reused until the user exit process completed.
  

Temporary fix

Comments

APAR Information

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

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

  UI49706 UI49707

Modules/Macros

• DFHZATMD
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI49706

     UP17/08/23 P F708

• R100 PSY UI49707

     UP17/08/23 P F708

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.