PH65287: CICS obtains excess 64-bit memory when processing the SIT RESOVERRIDES yaml file at startup

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Following the change to a RESOVERRIDES yaml file JVMs were not
  enabled in a few production regions. The CICS logs revealed
  messages DFHSJ0210 and DFHSJ0914 were being issued.
  The STDERR log show the message JVMJ9VM015W was being issued
  when the JVM was unable to obtain enough 64-bit memory to use
  as a Java heap.
  
  The problem was caused by excess 64-bit memory allocated at
  region start by CICS when the yaml file identified by the
  SIT RESOVERRIDES parameter is processed.
  

Local fix

• To mitigate the issue the customer increased the MEMLIMIT.
  Other possibilities are:
  - edit the yaml file to temporarily remove all the comments
  - (if possible) revert the use of the RESOVVERIDES SIT parm.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: During CICS startup message DFHSJ0210   *
  *                      with reason code 'CREATE_JVM_FAILED'    *
  *                      and DFHSJ0914 indicated that JVMs were  *
  *                      not enabled.  STDERR log showed message *
  *                      JVMJ9VM015W return code - 'Not enough   *
  *                      memory'.                                *
  ****************************************************************
  In the reported problem, a YAML file defined on the RESOVERRIDES
  SIT parameter has its size changed.  The YAML files are limited
  to 1MB in size.  During CICS initialisation, CICS module DFHPARC
  requests 64 bit memory for the file proportional to its size.
  However, the number of bytes required is passed on the GETSTOR
  request rather than the number of megabytes.
  This was interpreted as an unobtainable number of megabytes.
  

Problem conclusion

• DFHPARC has been modified to request memory in megabytes.
  

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:

  UO04747 UO04748 PH68197

Modules/Macros

• DFHPARC
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UO04748

     UP25/09/19 P F509

• R500 PSY UO04747

     UP25/09/05 P F509

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.