PH51510: PREVENT A CANCELLED ANGEL PROCESS FROM CALLING CALLRTM AGAINST THE CICS JOB STEP TCB OF A REGION WITH LIBERTY SERVER PROCESS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This APAR has been created to opt-in to the Liberty Angel change
  made by Liberty APAR PH48202.  This will prevent a cancelled
  Angel process from calling CALLRTM against the CICS job step TCB
  of a region containing a connected Liberty server process.
  CALLRTM against the CICS job step TCB can cause a CICS region to
  take many dumps and loop until force cancelled.  Messages issued
  by CICS if this occurs will include DFHSJ0005, BPXP018I,
  DFHSJ0001, DFHSJ0002, DFHSJ1007, DFHKE0997 and DFHKE1800.  An
  Angel should not be cancelled whilst it is connected to Liberty
  servers.  The purpose of this APAR is to reduce the impact on
  CICS if this happens but errors will still occur.
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS hangs or abends after cancellation *
  *                      of a Liberty angel process connected to *
  *                      a Liberty JVMSERVER.                    *
  ****************************************************************
  A Liberty JVMSERVER is enabled and connected to a Liberty angel
  process.  The angel process is then cancelled which causes the
  angel to abend the connected Liberty server to prevent
  unpredictable results.  This causes CICS to issue DFHSJ0005,
  DFHSJ0001 and DFHSJ0002 error messages, and attempt to disable
  then restart the JVMSERVER (DFHSJ1007).  However, as the angel
  process has indicated the CICS job step TCB should be
  terminated, the CICS region either hangs or abends with messages
  DFHKE0997 and DFHKE1800 issued.
  

Problem conclusion

• CICS has been updated to use the Liberty change made by PH48202.
  This means that if a Liberty JVMSERVER's connected angel process
  is cancelled the JVMSERVER will still fail with many error
  messages issued, but CICS will be able to successfully disable
  then re-enable it (assuming the required angel process is also
  restarted).
  
  Note, an angel process should not be cancelled whilst there are
  connected Liberty servers.  The purpose of this APAR is to
  reduce the impact but the consequences are still severe.
  
  The updated CICS behaviour requires the Liberty JVMSERVER to be
  running version 22.0.0.9 or higher.
  

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:

  PH52373 UI91954 UI91979 UI92075 UI92218

Modules/Macros

• DFHSJSC  DFJ@H356 DFJ@H467 DFJ@H468
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R103 PSY UI92075

     UP23/06/20 P F306 ¢

• R10D PSY UI91979

     UP23/06/20 P F306 ¢

• R200 PSY UI91954

     UP23/06/17 P F306 ¢

• R300 PSY UI92218

     UP23/06/17 P F306 ¢

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.