PM53414: SERVICEABILITY ENHANCEMENT FOR POOLED JVMS

Obtain the fix for this APAR.

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 3 Release 1
  Supplementary Data Areas, GC34-6905-00 has been altered in
  the section 'SJTCB SJ open TCB related data' 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 1304 into 1312 like:
  (0) STRUCTURE 1312 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:
  (514) FULLWORD  4 SJTCB_JVM_PID         JVM Process ID
  (518) ADDRESS   4 SJTCB_CAA_ADDRESS     CAA address
  (51C) ADDRESS   4 SJTCB_VM_ARGS         JVM options
  (520) CHARACTER 0 SJTCB_END
  
  The CICS Transaction Server for z/OS Version 3 Release 2
  Supplementary Data Areas, GC34-6864-04  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 1336 like:
  (0) STRUCTURE 1336 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:
  (52A) HALFWORD  2 SJTCB_CACHE_GENERATION  Cache generation no.
  (52C) ADDRESS   4 SJTCB_CAA_ADDRESS       CAA address
  (530) ADDRESS   4 SJTCB_VM_ARGS           JVM options
  (538) CHARACTER 0 SJTCB_END
  

APAR Information

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

  PM53405

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

  UK79126 UK79127 UK79128 UK79129

Modules/Macros

•    DESSJCON DESSJCS  DESSJDUF DFHAPSDF DFHSJAS
  DFHSJCC  DFHSJCL  DFHSJCON DFHSJCS  DFHSJCSH DFHSJDM  DFHSJDUF
  DFHSJGC  DFHSJIN  DFHSJIS  DFHSJJM  DFHSJOTC DFHSJOTD DFHSJOTH
  DFHSJPJP DFHSJSM  DFHSJST  DFHSJTRI
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK79126

     UP12/06/01 P F205

• R403 PSY UK79127

     UP12/06/01 P F205

• R500 PSY UK79128

     UP12/06/01 P F205

• R503 PSY UK79129

     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.