IBM Support

PH05672: SPECIFY AN ENVIRONMENT VARIABLE IN THE JVM PROFILE AND USE IT IN AN INCLUDE LOCATION IN SERVER.XML

A fix is available

Subscribe

You can track all active APARs for this component.

 

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

  • R00D PSY UI60850

       UP19/01/24 P F901

  • R10D PSY UI60851

       UP19/02/02 P F901

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