PH60532: UNABLE TO INSTALL/ENABLE A BUNDLE WHICH CONTAINS AN APPLICATION FOR A LIBERTY JVM SERVER 24/04/29 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• If a Liberty JVM server is enabled as follows:
  
  1) -Dcom.ibm.cics.jvmserver.wlp.autoconfigure=false is set in
  the JVM profile
  
  2) <include location="${server.output.dir}/installedApps.xml"/>
  is present in server.xml
  
  3) ${server.output.dir}/installedApps.xml does not exist on the
  file system
  
  then attempts to install/enable a BUNDLE which contains an
  application for the Liberty JVM server will fail.
  
  DFHSJ1100 will be issued with insert EXCEPTION_FROM_JVMSERVER.
  
  The JVMLOG and STDERR files will show a
  java.nio.file.NoSuchFileException occurred when
  readInstalledAppsXML() in
  CICSLibertyBundlepartControllerImpl.java was driven.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users with UI91006 or UI91005       *
  ****************************************************************
  * PROBLEM DESCRIPTION: Enabling a BUNDLE resource on a Liberty *
  *                      JVM server fails when the following     *
  *                      scenario is met:                        *
  *                      - autoconfigure in the JVM profile is   *
  *                      set to false                            *
  *                      - there is no installedApps.xml present *
  *                      - installedApps.xml include is within   *
  *                      the server.xml                          *
  ****************************************************************
  Given a Liberty JVM server with the following conditions:
  -Dcom.ibm.cics.jvmserver.wlp.autoconfigure=false is set in the
  JVM profile
  <include location="${server.output.dir}/installedApps.xml"/>
  is present in server.xml
  ${server.output.dir}/installedApps.xml does not exist on the
  file system
  
  Enabling a BUNDLE resource will fail with error DFHSJ1100.
  Within STDERR, there will be a NoSuchFileException thrown as
  CICS incorrectly attempts to read the installedApps.xml file
  which does not exist.
  
  This APAR also addresses a second problem where a BUNDLE is
  installed into a Liberty JVM server which has an
  installedApps.xml file, but no "include" element in server.xml
  which results in a timeout because Liberty is unaware of the
  configuration in installedApps.xml.  The timeout would be
  reported by CICSLibertyBundlepartMonitor in the JVMLOG and
  STDERR.
  

Problem conclusion

• UI91006 UI91005
  
  CICS has been updated to ensure that installedApps.xml is
  created if it does not already exist.
  
  CICS has also been updated to ensure there is always a
  installedApps.xml include within server.xml.
  

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:

  UI96713 UI96714

Modules/Macros

• DFHAPLJ1 DFHAPLJP DFHDSAC  DFHLEPTS DFHPIWR  DFHSJBD  DFHSJDM
  DFHSJDS  DFHSJJI  DFHSJJS  DFHSJRL  DFHSJSC  DFHSJST  DFHSJT8
  DFHSJTH  DFHSJTHT DFHSJTRI DFHXMIQ  DFJ@H350 DFJ@H351 DFJ@H352
  DFJ@H356 DFJ@H360 DFJ@H467 DFJ@H468 DFJ@H498 DFJ@H561 DFJ@H563
  DFJ@H571
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R200 PSY UI96714

     UP24/05/14 P F405 ­

• R300 PSY UI96713

     UP24/04/30 P F404 ­

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.