IBM Support

PM84825: PROPOSED CHANGES TO THE DEFAULT CICS SAMPLE JVM PROFILES

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A lot of the things in the CICS default Profiles are based on
    old JVM settings. Some of them still work, but aren't the best
    way to do things today.  For example, JAVA_DUMP_OPTS is
    deprecated and has been (for the most part) replaced by the
    -Xdump option.  There are other parameters that need updating
    as well.
    Additional Symptom(s) Search Keyword(s): KIXREVCTC
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Deprecated options used in sample CICS  *
    *                      JVM profiles.                           *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    Some of the options referenced in the CICS sample JVM profiles
    are no longer recommended by the IBM Java support teams.
    These options are -Xiss and -Xss.
    

Problem conclusion

  • The affected options have been removed from the sample CICS JVM
    profiles. Examples have been added for the -Xdump option,
    which is the preferred way to request dumps.
    Some other example options have been added.
    For CICS TS 5.1, the following profiles are updated:
     - DFHOSGI
     - DFHJVMAX
     - DFHWLP
    
    
    
    
    
    
    
    The CICS Transaction Server for z/OS Version 5 Release 1 'Java
    Applications in CICS' (SC34-2860-01) manual will be updated in
    the 'Control of Java dump options' topic.
    The first two lines will be replaced with:
    The -Xdump option can be used in a JVM profile to specify
    dump options to the JVM.
    
    The 'Java Applications in CICS' manual will also be updated in
    the 'Options for JVMs in a CICS environment' topic.
    The entry for JAVA_DUMP_OPTS will be removed.
    
    The CICS Transaction Server for z/OS Version 5 Release 1
    'Upgrading from Version 3 Release 1' (GC34-2874-01) manual will
    be updated in the 'Changes to options in JVM profiles' topic.
    The entry for JAVA_DUMP_OPS will be removed from table 1.
    
    The following options will be added to table 2:
    | -Xdump           | New for CICS sample profiles | Preferred |
        N/A | Examples provided in comments |
    | -Xcheck          | New for CICS sample profiles | Preferred |
        N/A | Examples provided in comments |
    | -Dibm.cl.verbose | New for CICS sample profiles | Preferred |
        N/A | Examples provided in comments |
    | -verbose         | New for CICS sample profiles | Preferred |
        N/A | Examples provided in comments |
    
    The CICS Transaction Server for z/OS Version 5 Release 1
    'Upgrading from Version 3 Release 2' (GC34-2875-01) manual will
    be updated in the 'Changes to options in JVM profiles' topic.
    JAVA_DUMP_OPTIONS will be added to table 1.
    | JAVA_DUMP_OPTS | Withdrawn from sample profiles | Accepted |
       -Xdump | Deprecated in Java 5 |
    
    The following options will be added to table 2:
    | -Xdump           | New for CICS sample profiles | Preferred |
       N/A | Examples provided in comments |
    | -Xcheck          | New for CICS sample profiles | Preferred |
       N/A | Examples provided in comments |
    | -Dibm.cl.verbose | New for CICS sample profiles | Preferred |
       N/A | Examples provided in comments |
    | -verbose         | New for CICS sample profiles | Preferred |
       N/A | Examples provided in comments |
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM84825

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-03-14

  • Closed date

    2013-03-28

  • Last modified date

    2015-03-04

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

    PM74955

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

    UK93403

Modules/Macros

  • DFHJVMAX DFHOSGI  DFHWLP
    

Publications Referenced
SC34286001GC34287401GC34287501  

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R800 PSY UK93403

       UP13/04/20 P F304

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.1","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.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
04 March 2015