IBM Support

PM74955: 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 used in the CICS sample JVM profiles are
    deprecated, and no longer recommended by the IBM Java support
    teams. These options are JAVA_DUMP_OPTS, -Xiss and -Xss.
    

Problem conclusion

  • The affected options have been removed from the sample CICS JVM
    profiles. JAVA_DUMP_OPTS is replaced by examples of the -Xdump
    option, which is the preferred way to request dumps.
    Some other example options have been added.
    For CICS TS 4.1, the following profiles are updated:
     - DFHJVMPR
     - DFHJVMCD
     - DFHJVMAX
    For CICS TS 4.2, the following profiles are updated:
     - DFHJVMPR
     - DFHJVMCD
     - DFHJVMAX
     - DFHOSGI
    
    
    
    
    
    
    
    The CICS Transaction Server for z/OS Version 4 Release 1 'Java
    Applications in CICS' (SC34-7025-02) 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 'DFHJVMCD, JVM profile reserved for CICS-supplied system
    programs' topic.
    The sample DFHJVMCD profile will be updated to reflect the new
    sample profile. A similar change will be made to the 'DFHJVMPR,
    JVM profile' and the 'DFHJVMAX, JVM profile reserved for the JVM
    server' topics.
    
    The 'Java Applications in CICS' manual will also be updated in
    the 'Options for JVMs in a CICS environment' topic.
    JAVA_DUMP_OPTS will be removed from the list of options, and the
    following options will be added:
    -Xdump  -- Use to control dump options. See "IBM SDK for z/OS
               platforms, Java Technology Edition, SDK Guide" or
               "IBM Developer Kit and Runtime Environment,
               Java Technology Edition, Diagnostics Guide" for
               further information
    -Xcheck  -- Use to debug JNI code
    -Dibm.cl.verbose  -- Use to enable you to trace the way the
               class loaders find and load application classes.
    -verbose  -- Turn on verbose output
    
    The CICS Transaction Server for z/OS Version 4 Release 1 "What's
    new" (GC34-6994-03) manual will be updated in the "JVM profiles:
    options and samples" topic. JAVA_DUMP_OPTS will be removed from
    table 1, and -Xdump, -verbose, -Xcheck, and -Dibm.cl.verbose
    will be added. JAVA_DUMP_OPTS will also be removed from the text
    under the 'Unix System Services environment variables' section
    in that topic.
    
    The CICS Transaction Server for z/OS Version 4 Release 1
    'Upgrading from Version 2 Release 3' (GC34-6996-03) manual will
    be updated in the 'Changes to options in JVM profiles' topic.
    JAVA_DUMP_OPTS will be removed from table 1. The following
    options will be added:
    | -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 same changes will be made in the CICS Transaction Server for
    z/OS Version 4 Release 1 'Upgrading from Version 3 Release 1'
    (GC34-6997-03) manual.
    
    The CICS Transaction Server for z/OS Version 4 Release 1
    'Upgrading from Version 3 Release 2' (GC34-6998-03) 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:
    | -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 4 Release 2 'Java
    Applications in CICS' (SC34-7174-02) 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 'DFHJVMCD, JVM profile reserved for CICS-supplied system
    programs' topic.
    The sample DFHJVMCD profile will be updated to reflect the new
    sample profile. A similar change will be made to the 'DFHJVMPR,
    JVM profile', 'DFHJVMAX, JVM profile reserved for the JVM
    server', and 'DFHOSGI, JVM profile for the JVM server' topics.
    
    The 'Java Applications in CICS' manual will also be updated in
    the 'JVM profiles: options and samples' topic. JAVA_DUMP_OPTS
    will be removed from table 1, and -Xdump, -verbose, -Xcheck, and
    -Dibm.cl.verbose will be added. JAVA_DUMP_OPTS will also be
    removed from the text under the 'Unix System Services
    environment variables' section in that topic.
    
    The 'Java Applications in CICS' manual will also be updated in
    the 'Setting up a JVM server for DB2' topic. JAVA_DUMP_OPTS will
    be removed from the JVM profile excerpt.
    
    The CICS Transaction Server for z/OS Version 4 Release 2
    'Upgrading from Version 3 Release 1' (GC34-7188-02) manual will
    be updated in the 'Changes to options in JVM profiles' topic.
    JAVA_DUMP_OPTS will be removed from table 1.
    
    The following options will be added:
    | -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 4 Release 2
    'Upgrading from Version 3 Release 2' (GC34-7189-02) 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:
    | -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

    PM74955

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    60M

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-10-12

  • Closed date

    2013-03-28

  • Last modified date

    2013-05-03

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

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

    PM84825 UK93331 UK93332 UK93333 UK93334

Modules/Macros

  •    DFHJVMAX DFHJVMCD DFHJVMPR DFHOSGI  DFHSJPJP
    

Publications Referenced
SC34702502GC34699403GC34699603GC34699703GC34699803
SC34717402GC34718802GC34718902  

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R600 PSY UK93331

       UP13/04/20 P F304

  • R603 PSY UK93332

       UP13/04/20 P F304

  • R700 PSY UK93333

       UP13/04/20 P F304

  • R703 PSY UK93334

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

Document Information

Modified date:
03 May 2013