PH52373: 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.
  
  Additionally, during the completion of this APAR it was found
  that the sjke_in_java flag used internally by CICS is not set
  correctly for a JVMSERVER's:
   - system thread when it is not in use
   - application threads before their first use
  

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.
  
  Additionally, DFHSJIN has been updated to set sjke_in_java on
  and off as threads are dispatched into and return from the JVM.
  

Temporary fix

Comments

APAR Information

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

  PH51510

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

  UI92205

Modules/Macros

• DFHSJIN  DFHSJSC  DFJ@H467 DFJ@H609
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UI92205

     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.