IBM Support

PK87714: EXPOSE CPSMDUMP ACTION THROUGH API AND WEB USER INTERFACE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as unreproducible in next release.

Error description

  • In order to collect system dumps containing the necessary data
    to diagnose CPSM problems, clients must logon to the target
    CMAS or MAS and execute the XZSD method through the CPSM debug
    transaction COD0, or must enter a long and quite specific dump
    specification through the system DUMP command enteres through a
    console.
    When an internal dump is requested by the CPSM trace service
    method, XZPT, the XZPT stack frame overlays the stack frames of
    the last method chain called from the requesting method.  This
    might make problem determination more difficult by overwriting
    storage which could be relevant to the problem.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
    ****************************************************************
    * PROBLEM DESCRIPTION:    In order to collect system dumps     *
    *                      containing the necessary storage areas  *
    *                      to diagnose CPSM problems, clients must *
    *                      log on to the target CMAS or MAS and    *
    *                      execute a method through the CPSM debug *
    *                      transaction COD0, or must type a long   *
    *                      and quite specific dump specification   *
    *                      through the system DUMP command entered *
    *                      at a system console.                    *
    *                         When an internal dump is requested   *
    *                      by the CPSM trace service, CICS storage *
    *                      which could be relevant to the problem  *
    *                      may be overlaid by the trace method's   *
    *                      stack frame.                            *
    ****************************************************************
    * RECOMMENDATION:    If CMASes executing CPSM for CICS         *
    *                 Transaction Server V3.1 connect directly     *
    *                 or indirectly to a CMAS executing CPSM for   *
    *                 CICS Transaction Server V3.2 or CPSM for     *
    *                 CICS Transaction Server V4.1, the PTF which  *
    *                 resolves this APAR must be applied to allow  *
    *                 dumps to be requested of the lower level     *
    *                 CMASes.                                      *
    *                                                              *
    *                 The PTFs which resolve the following APARs   *
    *                 must be applied to allow dumps to be re-     *
    *                 quested of this CMAS, or MASes connected     *
    *                 to this CMAS.                                *
    *                                                              *
    *                   - CTS 3.2 - CPSM 3.2.0 - APAR PK87706      *
    *                   - CTS 4.1 - CPSM 4.1.0 - APAR PK87713      *
    *                                                              *
    *                    After applying the PTF which resolves     *
    *                 this APAR, all CMASes and MASes must be      *
    *                 recycled to pick up the new code.  Note      *
    *                 that regions do not have to be restarted     *
    *                 at the same time.  However, until a CMAS     *
    *                 is executing from libraries to which the     *
    *                 appropriate PTF has been applied, it will    *
    *                 not be possible to request dumps of the      *
    *                 CMAS, or any MASes connected to it, from     *
    *                 an API program or Web User Interface (WUI)   *
    *                 view from a server executing CPSM V3.2 or    *
    *                 CPSM V4.1.                                   *
    ****************************************************************
       In order to collect system dumps containing the necessary
    data to diagnose CPSM problems, clients must logon to the target
    CMAS or MAS and execute the XZSD method through the CPSM debug
    transaction COD0, or must enter a long and quite specific dump
    specification through the system DUMP command entered at a
    system console.
       This APAR adds support for the new CPSMDUMP action in CPSM
    for CICS Transaction Server V3.2 and higher.  This will allow
    dumps to be requested for CMASes and MASes executing CPSM for
    CICS Transaction Server V3.1 which are in a CICSplex managed
    from the Web User Interface (WUI) in a server executing CPSM
    for CICS Transaction Server V3.2 or higher.
       Using the ability of module EYU0XZSD (XZSD - Request System
    Dump) to specify an optional additional address space to be
    dumped along with the CMAS and ESSS, it will be possible to dump
    a MAS address space even if a new task cannot be started in the
    MAS.
    
       When a system dump is requested in a call to the CPSM trace
    service module EYU0XZPT (XZPT - Trace Services Write Trace), the
    XZPT stack frame overlays the stack frames of the last method
    chain called by the requesting method.  This might make problem
    determination more difficult by overwriting storage which could
    be relevant to the problem.
       This APAR updates module EYU9XLMC (XLMC - Kernel Linkage
    Method Call) to allocate the stack frame for XZPT in an Overflow
    Stack Segment Block (OSSB) if a system dump has been requested.
    This prevents overlaying the stack frames of the last method
    chain called from the requesting method.
    

Problem conclusion

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

  •    In order to collect system dumps containing the necessary
    data to diagnose CPSM problems, clients must logon to the target
    CMAS or MAS and execute the XZSD method through the CPSM debug
    transaction COD0, or must enter a long and quite specific dump
    specification through the system DUMP command entered at a
    system console.
       This APAR adds support for the new CPSMDUMP action in CPSM
    for CICS Transaction Server V3.2 and higher.  This will allow
    dumps to be requested for CMASes and MASes executing CPSM for
    CICS Transaction Server V3.1 which are in a CICSplex managed
    from the Web User Interface (WUI) in a server executing CPSM
    for CICS Transaction Server V3.2 or higher.
       Using the ability of module EYU0XZSD (XZSD - Request System
    Dump) to specify an optional additional address space to be
    dumped along with the CMAS and ESSS, it will be possible to dump
    a MAS address space even if a new task cannot be started in the
    MAS.
    
       When a system dump is requested in a call to the CPSM trace
    service module EYU0XZPT (XZPT - Trace Services Write Trace), the
    XZPT stack frame overlays the stack frames of the last method
    chain called by the requesting method.  This might make problem
    determination more difficult by overwriting storage which could
    be relevant to the problem.
       This APAR updates module EYU9XLMC (XLMC - Kernel Linkage
    Method Call) to allocate the stack frame for XZPT in an Overflow
    Stack Segment Block (OSSB) if a system dump has been requested.
    This prevents overlaying the stack frames of the last method
    chain called from the requesting method.
    

APAR Information

  • APAR number

    PK87714

  • Reported component name

    CPSM CICS 3.1

  • Reported component ID

    5655M1501

  • Reported release

    100

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2009-06-01

  • Closed date

    2010-07-28

  • Last modified date

    2010-08-02

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

    PK87706

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

    UK59230

Modules/Macros

  •    EYUCXXRS EYUQXXRC EYUQXZXD EYURXZXD EYUTMOMI
    EYUTMOSD EYUTRDIR EYUTRTRC EYUTVOSX EYUUXXFI EYUUXXRS EYUUXXTC
    EYUYXZXD EYUZXZXD EYU0XZSD EYU0XZXD EYU9XLMC EYU9XZPU EYU9XZP3
    EYU9XZP4 EYU9XZP5 EYU9XZP6 HCP3100J
    

Fix information

  • Fixed component name

    CPSM CICS 3.1

  • Fixed component ID

    5655M1501

Applicable component levels

  • R100 PSY UK59230

       UP10/07/30 P F007

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.

{"0":{"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":"3.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},"404":{"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Line of Business":{"code":"LOB35","label":"Mainframe SW"}},"1":null,"2":null,"3":null,"4":null,"5":null,"6":null,"7":null,"8":null,"9":null,"10":null,"11":null,"12":null,"13":null,"14":null,"15":null,"16":null,"17":null,"18":null,"19":null,"20":null,"21":null,"22":null,"23":null,"24":null,"25":null,"26":null,"27":null,"28":null,"29":null,"30":null,"31":null,"32":null,"33":null,"34":null,"35":null,"36":null,"37":null,"38":null,"39":null,"40":null,"41":null,"42":null,"43":null,"44":null,"45":null,"46":null,"47":null,"48":null,"49":null,"50":null,"51":null,"52":null,"53":null,"54":null,"55":null,"56":null,"57":null,"58":null,"59":null,"60":null,"61":null,"62":null,"63":null,"64":null,"65":null,"66":null,"67":null,"68":null,"69":null,"70":null,"71":null,"72":null,"73":null,"74":null,"75":null,"76":null,"77":null,"78":null,"79":null,"80":null,"81":null,"82":null,"83":null,"84":null,"85":null,"86":null,"87":null,"88":null,"89":null,"90":null,"91":null,"92":null,"93":null,"94":null,"95":null,"96":null,"97":null,"98":null,"99":null,"100":null,"101":null,"102":null,"103":null,"104":null,"105":null,"106":null,"107":null,"108":null,"109":null,"110":null,"111":null,"112":null,"113":null,"114":null,"115":null,"116":null,"117":null,"118":null,"119":null,"120":null,"121":null,"122":null,"123":null,"124":null,"125":null,"126":null,"127":null,"128":null,"129":null,"130":null,"131":null,"132":null,"133":null,"134":null,"135":null,"136":null,"137":null,"138":null,"139":null,"140":null,"141":null,"142":null,"143":null,"144":null,"145":null,"146":null,"147":null,"148":null,"149":null,"150":null,"151":null,"152":null,"153":null,"154":null,"155":null,"156":null,"157":null,"158":null,"159":null,"160":null,"161":null,"162":null,"163":null,"164":null,"165":null,"166":null,"167":null,"168":null,"169":null,"170":null,"171":null,"172":null,"173":null,"174":null,"175":null,"176":null,"177":null,"178":null,"179":null,"180":null,"181":null,"182":null,"183":null,"184":null,"185":null,"186":null,"187":null,"188":null,"189":null,"190":null,"191":null,"192":null,"193":null,"194":null,"195":null,"196":null,"197":null,"198":null,"199":null,"200":null,"201":null,"202":null,"203":null,"204":null,"205":null,"206":null,"207":null,"208":null,"209":null,"210":null,"211":null,"212":null,"213":null,"214":null,"215":null,"216":null,"217":null,"218":null,"219":null,"220":null,"221":null,"222":null,"223":null,"224":null,"225":null,"226":null,"227":null,"228":null,"229":null,"230":null,"231":null,"232":null,"233":null,"234":null,"235":null,"236":null,"237":null,"238":null,"239":null,"240":null,"241":null,"242":null,"243":null,"244":null,"245":null,"246":null,"247":null,"248":null,"249":null,"250":null,"251":null,"252":null,"253":null,"254":null,"255":null,"256":null,"257":null,"258":null,"259":null,"260":null,"261":null,"262":null,"263":null,"264":null,"265":null,"266":null,"267":null,"268":null,"269":null,"270":null,"271":null,"272":null,"273":null,"274":null,"275":null,"276":null,"277":null,"278":null,"279":null,"280":null,"281":null,"282":null,"283":null,"284":null,"285":null,"286":null,"287":null,"288":null,"289":null,"290":null,"291":null,"292":null,"293":null,"294":null,"295":null,"296":null,"297":null,"298":null,"299":null,"300":null,"301":null,"302":null,"303":null,"304":null,"305":null,"306":null,"307":null,"308":null,"309":null,"310":null,"311":null,"312":null,"313":null,"314":null,"315":null,"316":null,"317":null,"318":null,"319":null,"320":null,"321":null,"322":null,"323":null,"324":null,"325":null,"326":null,"327":null,"328":null,"329":null,"330":null,"331":null,"332":null,"333":null,"334":null,"335":null,"336":null,"337":null,"338":null,"339":null,"340":null,"341":null,"342":null,"343":null,"344":null,"345":null,"346":null,"347":null,"348":null,"349":null,"350":null,"351":null,"352":null,"353":null,"354":null,"355":null,"356":null,"357":null,"358":null,"359":null,"360":null,"361":null,"362":null,"363":null,"364":null,"365":null,"366":null,"367":null,"368":null,"369":null,"370":null,"371":null,"372":null,"373":null,"374":null,"375":null,"376":null,"377":null,"378":null,"379":null,"380":null,"381":null,"382":null,"383":null,"384":null,"385":null,"386":null,"387":null,"388":null,"389":null,"390":null,"391":null,"392":null,"393":null,"394":null,"395":null,"396":null,"397":null,"398":null,"399":null,"400":null,"401":null,"402":null,"403":null}

Document Information

Modified date:
22 February 2023