PH64731: Externalise Angel Check API return code without activating CICS tracing.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Before a Liberty JVM server is started, CICS uses the Angel
  Check API to ensure the Angel process is started, if
  angelRequired=true is set.
  
  If the Liberty angel process is not found for any reason,
  CICS issues the following message:
  
  DFHSJ0210 An attempt to start a JVM for the JVMSERVER resource
  EYUCMCIJ has failed. Reason code: ANGEL_UNAVAILABLE
  
  The reason code ANGEL_UNAVAILABLE is too generic and the
  actual return code is only printed out if CICS tracing is
  enabled.
  
  Additional Keywords:  BGVT KIXREVQWD
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS doesn't externalise the reason     *
  *                      code from the angel check process if    *
  *                      the angel process is not found.         *
  ****************************************************************
  When the Liberty JVM server is started with angelRequired=true,
  DFHSJSC will check to make sure the Angel process is running.
  If the check fails, there are 4 different possibilities for the
  failure but the reason code that differentiates the failure is
  not externalised unless CICS tracing is enabled; only a
  generalised failure reason code ANGEL_UNAVAILABLE is
  published.
  

Problem conclusion

• CICS has been modified to print the message, usually only issued
  if CICS trace is enabled, to STDERR for any failures in the
  angel check.
  

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:

  UO03167 UO03168

Modules/Macros

• DFHSJSC  DFJ@H467 DFJ@H609
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UO03168

     UP25/05/14 I 1000

• R500 PSY UO03167

     UP25/05/14 I 1000

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.