PH46591: ENABLE THE --CLEAN LIBERTY START OPTION BASED ON THE TIME STAMPS OF CERTAIN FILES WITHIN THE CICS USSHOME DIRECTORY

APAR status

• Closed as program error.

Error description

• Prior to PH17642 CICS always started Liberty with --clean
  specified. To allow Liberty to take advantage of its cache for
  performance reasons --clean was removed.
  
  The WLP --clean option cleans all persistent cached information
  that is related to the specified server instance.
  
  However, it is sometimes necessary to use the --clean option
  to clear out cached data when starting a Liberty JVM. This may
  be related to fix updates or other changes as described at;
  https://www.ibm.com/docs/en/was-liberty/base?topic=line-server-
  command-options
  
  If --clean is not used, unpredictable issues may occur with the
  Liberty JVM after changes have been applied, such as when trying
  to connect from the Explorer to the CMCI port, the following
  error is presented;
  
  IZE0106E Connect failed with error "Unexpected content type:
  text/html;charset=ISO-8859-1, Internet Server Error"
  
  With this APAR, if the timestamps on certain files in USSHOME
  have been changed the --clean option will be enabled for the
  next enable of the JVMSERVER.
  
  Additional symptoms:
  KIXREVSVR
  

Local fix

• Use the -Dcom.ibm.cics.jvmserver.wlp.args=--clean  option to
  start the Liberty JVM
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: CMCI JVM server fails to start          *
  *                      correctly after maintenance is applied. *
  ****************************************************************
  CICS maintenance is applied that updates CICS Liberty Java parts
  or applies a Liberty fixpack. The CICS regions restart
  successfully and the JVM servers enable correctly, however the
  CMCI JVM server fails to enable due to the following error in
  messages.log:
  
  org.apache.cxf.interceptor.Fault: Couldn't parse CMCI URL
  

Problem conclusion

• JVM servers have been updated to track CICS Liberty Java parts
  or Liberty fixpacks and add the --clean option to a Liberty
  server if a part has changed.
  

Temporary fix

Comments

APAR Information

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

  PH40966

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

  UI80736

Modules/Macros

• DFJ@H350
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels