A fix is available
APAR status
Closed as program error.
Error description
The customer is trying to specify an include in their Liberty JVM server's server.xml where part of the path is defined by an environment variable. For example: . You specify in the Liberty jvm profile: PH05672=/u/user/wlp/server . You then specify in the server.xml file: <include location= "${env.PH05672}/test_server_xml_include_for_ph05672.xml"/> . This does not get resolved at runtime which prevents the Liberty JVM server from starting successfully.
Local fix
usermode
Problem summary
**************************************************************** * USERS AFFECTED: All CICS Users. * **************************************************************** * PROBLEM DESCRIPTION: Specifying environment variables in * * server.xml results in Liberty JVM * * server failing to initialize * **************************************************************** A Liberty JVM server has been configured in CICS. The Liberty server.xml file contains an <include> element. The location attribute of the element uses an environment variable as part of the file path. When CICS start the JVM server it processes the server.xml file. CICS does not resolve the environment variable. This causes the include file to not be found. The CICS router throws an exception and the Liberty JVM server fails to initialize. An example of such an include is <include location="${env.PH05672}/userInclude.xml"/>
Problem conclusion
The CICS processing of server.xml has been updated to resolve any environment variables used with <include> elements.
Temporary fix
Comments
APAR Information
APAR number
PH05672
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
000
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2018-11-27
Closed date
2019-01-22
Last modified date
2019-03-12
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI60850 UI60851
Modules/Macros
DFJ@H350
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"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.3","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.3","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
12 March 2019