A fix is available
APAR status
Closed as new function.
Error description
Serviceability enhancements for pooled JVMs
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users * **************************************************************** * PROBLEM DESCRIPTION: A serviceability enhancement is needed * * to store CAA address and JVM options * * for each pooled JVM and make them * * available in the dump. * **************************************************************** * RECOMMENDATION: * **************************************************************** A dump of CICS containing several pooled JVMs is being formatted using the LEDATA formatter. If a user task was running in a JVM at the time of the dump then the LEDATA formatter will be able to locate all of the LE control blocks automatically from the J8 or J9 TCB. If the JVM was idle then the J8 or J9 TCB is no longer within the associated CEEPIPI enclave and the LEDATA formatter fails to locate the LE control blocks. The LE control blocks could be formatted if the CAA address was known, but CICS does not save that address and it is difficult and time consuming to locate manually within the dump. It is also beneficial to be able to see exactly which options the JVMs in the dump were started with. This information is contained within a block of storage in the CEEPIPI enclave but the address of that block is not made available to the dump formatter.
Problem conclusion
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
Two new fields have been added to the SJTCB control block. These fields contain the LE CAA address of the associated CEEPIPI enclave and the address of the JVM options block. DFHSJCS has been updated to store the address of the CAA and the JVM options block in the SJTCB when a new JVM is created. DFHSJDUF has been updated to format out the CAA and JVM options addresses and to format out all the JVM options that were set for each SJTCB when SJ=2 or 3 is requested. The CICS Transaction Server for z/OS Version 4 Release 1 Supplementary Data Areas, GC34-7015-03 has been altered in the section 'SJTCB SJ open TCB related data *OWC' where two new fields containing the LE CAA address of the associated CEEPIPI enclave and the address of the JVM options block are added. At the beginning of the section, the length of SJTCB should be changed from 1328 into 1344 like: (0) STRUCTURE 1344 SJTCB At the end of the section, two new fields SJTCB_CAA_ADDRESS and SJTCB_VM_ARGS are added after SJTCB_JVM_PID and also the offset of SJTCB_END need to be changed like: (52B) CHARACTER 6 SJTCB_JAVA_VERSION 1.6.0 or 6.0.1 (531) CHARACTER 3 * Reserved (534) ADDRESS 4 SJTCB_CAA_ADDRESS CAA address (538) ADDRESS 4 SJTCB_VM_ARGS JVM options (540) CHARACTER 0 SJTCB_END
APAR Information
APAR number
PM53405
Reported component name
CICS TS Z/OS V4
Reported component ID
5655S9700
Reported release
600
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / Serviceability
Submitted date
2011-12-05
Closed date
2012-05-26
Last modified date
2012-06-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PM53414 UK79113 UK79114 UK79115 UK79116
Modules/Macros
DESSJCON DESSJCS DESSJDUF DFHAPSDF DFHSJAS DFHSJBD DFHSJCC DFHSJCL DFHSJCON DFHSJCS DFHSJCSH DFHSJDM DFHSJDS DFHSJDUF DFHSJGC DFHSJIN DFHSJIS DFHSJJS DFHSJOTC DFHSJOTD DFHSJOTH DFHSJPJP DFHSJRL DFHSJSM DFHSJST DFHSJTH DFHSJTRI
GC34701503 |
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
Applicable component levels
R600 PSY UK79113
UP12/06/01 P F205
R603 PSY UK79114
UP12/06/01 P F205
R700 PSY UK79115
UP12/06/01 P F205
R703 PSY UK79116
UP12/06/01 P F205
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 June 2012