PH48714: PREVENT CICS FROM REWRITING CICSTSDEFAULTJDBC.XML UNLESS NECESSARY WHEN ENABLING A LIBERTY JVMSERVER.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The client has 2 CICS regions that start at the same time. The
  first region's JVM server starts as expected but the second
  region ends up with the JVM in a disabled state. During each JVM
  start up an attempt is made to access the
  cicstsDefaultJdbc.xml file and if this access fails then the
  region starts up with JVM in a disabled state. In
  this case both JVM servers are attempting to access the file at
  the same time. The following error
  is seen in dfhjvmerr for the second region :
  java.nio.file.NoSuchFileException:
  /var/cicsts/CICSELC/wlp/usr/servers/defaultServer/configDropins/
  defaults/cicstsDefaultJdbc.xml
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: When more than one Liberty JVM servers  *
  *                      are enabled at the same time, a subset  *
  *                      of the servers may fail to start with   *
  *                      Java exception                          *
  *                      java.nio.file.NoSuchFileException for   *
  *                      file cicstsDefaultJdbc.xml, and enter a *
  *                      disabled state.                         *
  ****************************************************************
  During Liberty JVM server initialisation with autoconfigure set
  (-Dcom.ibm.cics.jvmserver.wlp.autonfigure=true). When the server
  configuration is being processed, the template file for
  cicstsDefaultJdbc.xml is always copied to the servers configured
  dropin directory overwriting the existing file. If more than one
  JVM server is configured to use the same directory, and are
  enabled at the same time, if during this delete the subsequent
  JVM server attempts to access or overwrite this file, the JVM
  server will fail with exception
  java.nio.file.NoSuchFileException. This results in the JVM
  server initialisation to fail, and return to disabled state.
  

Problem conclusion

• Liberty JVM server initialisation has been changed to prevent
  the file cicstsDefaultJdbc.xml from being overwritten
  unnecessarily.
  

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:

  UI83035 UI83036

Modules/Macros

• DFJ@H350 DFJ@H571
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R200 PSY UI83036

     UP22/10/29 P F210

• R300 PSY UI83035

     UP22/11/01 P F210

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.