A fix is available
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
SC34702502 | GC34699403 | GC34699603 | GC34699703 | GC34699803 |
SC34717402 | GC34718802 | GC34718902 |
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