IBM Support

PM53405: SERVICEABILITY ENHANCEMENT FOR POOLED JVMS

A fix is available

Subscribe

You can track all active APARs for this component.

 

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
    

Publications Referenced
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