IBM Support

PH55755: INCLUDE -XMS256M IN ISCDEPLOY.SC SCRIPT JOPTIONS SETTING

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

  • If the default JVM heap values have been changed via environment
    variables so the initial (minimum) heap size is larger than
    512M, the iscdeploy script will fail with
    
    JVMJ9GC019E -Xms too large for -Xmx
    

Local fix

  • Edit the  iscdeploy.sh script to add  the -Xms value so it reads
    
    
    JOPTIONS="-Xms256m -Xmx512m"
    
    
    To check the system JVM settings issue this command in USS:
    
    env
    
    
    It will show something like this example:
    
    IBM_JAVA_OPTIONS=-Xms1024M -Xmx1024M
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:  All z/OS users of IBM WebSphere Application *
    *                  Server Administrative console iscdeploy.sh  *
    *                  script                                      *
    ****************************************************************
    * PROBLEM DESCRIPTION: If the default JVM heap values are      *
    *                      changed via environment variables so    *
    *                      the                                     *
    *                      initial (minimum) heap size is larger   *
    *                      than 512M, the iscdeploy.sh fails       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    If the default JVM heap values are changed via environment
    variables so the initial (minimum) heap size is larger than
    512M,
    the iscdeploy.sh script fails JVMJ9GC019E -Xms too large for -
    Xmx
    This does not affect iscdeploy.bat script.
    

Problem conclusion

  • -Xms256m was added to the iscdeploy.sh script for z/OS.
    
    The fix for this APAR is targeted for inclusion in fix pack
    8.5.5.25 and 9.0.5.19. For more information, see 'Recommended
    Updates for WebSphere Application Server':
    https://www.ibm.com/support/pages/node/715553
    

Temporary fix

  • -Xms256m can be added to the JOPTIONS under the z/OS block in th
    iscdeploy.sh script
    

Comments

APAR Information

  • APAR number

    PH55755

  • Reported component name

    WEBSPHERE FOR Z

  • Reported component ID

    5655I3500

  • Reported release

    900

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2023-07-13

  • Closed date

    2023-12-12

  • Last modified date

    2023-12-12

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

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

Fix information

  • Fixed component name

    WEBSPHERE FOR Z

  • Fixed component ID

    5655I3500

Applicable component levels

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS7K4U","label":"WebSphere Application Server for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"900","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
13 December 2023