A fix is available
APAR status
Closed as program error.
Error description
A client applied some z/OS maintenance and this included an update to their level of Java. On restarting CICS after this change they found that some of their Liberty applications were not started. They then set -Dcom.ibm.cics.jvmserver.wlp.args=--clean in their jvmprofile and the subsequent restart worked as expected. This APAR extends PH46591 such that any change to level of Java is detected and as a result the --clean setting is used automatically to ensure that the Liberty/OSGI cache is cleared when CICS is restarted.
Local fix
Set -Dcom.ibm.cics.jvmserver.wlp.args=--clean in the jvmprofile
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users. * **************************************************************** * PROBLEM DESCRIPTION: Link to Liberty programs unavailable * * after changing Java versions. * **************************************************************** After applying Java maintenance a link to Liberty program did not enable. The JVM server JVMERR file showed: [com.ibm.cics.wlp.link.impl] [LinkableServicesFinder] @Error: findLinkableServicesInContainer() - Error parsing linkable services XML com.ibm.cics.wlp.link.LinkableTargetMetadataParsingException: An error occurred while parsing: unexpected element (uri:"http://www.ibm.com/xmlns/prod/cics/link", local:"linkableTargets"). Expected elements are (none)
Problem conclusion
CICS has been changed to check if Java has been updated since last enabling the JVM server. If this is the case, Liberty will be started with '--clean'.
Temporary fix
Comments
APAR Information
APAR number
PH49238
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
200
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2022-09-02
Closed date
2022-12-19
Last modified date
2023-01-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PH51349 UI83789 UI83790
Modules/Macros
DFJ@H350 DFJ@H571
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
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.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.5","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
05 January 2023