PK87713: EXPOSE CPSMDUMP ACTION THROUGH API AND WEB USER INTERFACE

Obtain the fix for this APAR.

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 V4R1M0 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: After applying the PTF that resolves this    *
  *                 APAR, all CMASes and MASes must be recycled  *
  *                 to pick up the new code.                     *
  *                                                              *
  *                 The restarts need not be performed at the    *
  *                 same time, however if systems are not        *
  *                 restarted at the same time, the following    *
  *                 rules apply:                                 *
  *                                                              *
  *                 - Maintenance Point (MP) CMASes must be re-  *
  *                   started on the updated code before non-MP  *
  *                   CMASes.                                    *
  *                                                              *
  *                 - If you have more than one MP CMAS and any  *
  *                   of those MP CMASes are connected directly  *
  *                   or indirectly, then those MP CMASes must   *
  *                   be restarted at the same time.             *
  *                                                              *
  *                 - Before a MAS or WUI server is restarted    *
  *                   with the updated code, the CMAS to which   *
  *                   the MAS or WUI server connects must be     *
  *                   running with the updated code.             *
  *                                                              *
  *                 If a CMAS executing from libraries in which  *
  *                 the PTF resolving this APAR is applied,      *
  *                 connects directly or indirectly to a CMAS    *
  *                 executing CPSM for CICS Transaction Server   *
  *                 V3.1 or CPSM for CICS Transaction Server     *
  *                 V3.2, the PTFs which resolve the following   *
  *                 APARs must be applied to allow dumps to be   *
  *                 requested of the lower level CMASes:         *
  *                                                              *
  *                  - CTS 3.1 - CPSM 3.1.0 - APAR PK87714       *
  *                  - CTS 3.2 - CPSM 3.2.0 - APAR PK87706       *
  *                                                              *
  *                 Note that CMASes executing V3.1 of CPSM do   *
  *                 not have to be restarted at the same time,   *
  *                 or in any particular order.  However, until  *
  *                 a CMAS is executing from libraries to which  *
  *                 the appropriate PTF has been applied, any    *
  *                 attempt to request dumps of the CMAS, or     *
  *                 any MASes connected to it, will cause the    *
  *                 API program to hang until the request is     *
  *                 timed out.                                   *
  *                                                              *
  *                 CMASes executing V3.2 of CPSM need not be    *
  *                 restarted at the same time.  However if      *
  *                 CMASes are not restarted at the same time,   *
  *                 the following restrictions apply:            *
  *                                                              *
  *                 CMASes executing V4.1 of CICSPlex SM which   *
  *                 connect directly or indirectly to CMASes     *
  *                 executing V3.2 of CPSM must be restarted     *
  *                 from libraries to which the appropriate PTF  *
  *                 is applied, before any CMASes which execute  *
  *                 V3.2 of CPSM.                                *
  *                                                              *
  *                 Additionally, you must re-import the         *
  *                 updated viewsets and menu definitions        *
  *                 from the CICSPlex SM supplied starter        *
  *                 set into each Web User Interface (WUI)       *
  *                 server's repository in order to pick up      *
  *                 the changes.                                 *
  *                                                              *
  *                 The starter set viewsets and menus can be    *
  *                 imported either via the AUTOIMPORTDSN and    *
  *                 AUTOIMPORTMEM WUI server initialization      *
  *                 parameters or the IMPORT (from a dataset)    *
  *                 function of the COVC WUI transaction.        *
  *                                                              *
  *                 If COVC is used to re-import the starter     *
  *                 set, ensure that the OVERWRITE import option *
  *                 is specified if the WUI server's repository  *
  *                 previously contained that starter set        *
  *                 viewsets and menus.                          *
  *                                                              *
  *                 For details on the COVC IMPORT function see  *
  *                 'The CICSPlex SM Web User Interface          *
  *                 transaction (COVC)' in the CICS Transaction  *
  *                 Server for z/OS Version 4 Release 1 CICSPlex *
  *                 SM Web User Interface Guide (SC34-7045).     *
  *                                                              *
  *                 The updated starter set member name that     *
  *                 needs to be imported is:                     *
  *                                                              *
  *                 Views:                                       *
  *                    EYUxA00D - EYUSTARTMAS viewset            *
  *                    EYUxA1W2 - EYUSTARTCMASLIST viewset       *
  *                    EYUxA1W3 - EYUSTARTCMAS viewset           *
  *                                                              *
  *                 Replace x with the required language version *
  *                 to be imported:                              *
  *                 E - English, K - Japanese, S - Chinese.      *
  *                                                              *
  *                 Insure that the import references the        *
  *                 SEYUVIEW dataset that was updated by the PTF *
  *                 that resolves this APAR.                     *
  ****************************************************************
     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 a new CPSMDUMP action to the CMASLIST, CMAS,
  and MAS Resource Tables.  This will allow dumps containing all
  storage required to diagnose CPSM problems to be requested from
  an API program, or from the Web User Interface (WUI).  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, a MAS address space can be dumped even
  if it is not possible to start a new task in the MAS.
  

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 a new CPSMDUMP action to the CMASLIST, CMAS,
  and MAS Resource Tables.  This will allow dumps containing all
  storage required to diagnose CPSM problems to be requested from
  an API program, or from the Web User Interface (WUI).  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, a MAS address space can be dumped even
  if it is not possible to start a new task in the MAS.
  

APAR Information

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

  PK87706

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

  UK59233

Modules/Macros

•    CMAS     CMASLIST EYUA2443 EYUA2450 EYUA2451
  EYUB2443 EYUB2451 EYUCXXRS EYUC2443 EYUC2450 EYUC2451 EYUEA00D
  EYUEA1W2 EYUEA1W3 EYUE2443 EYUE2450 EYUE2451 EYUKA00D EYUKA1W2
  EYUKA1W3 EYUK2443 EYUK2450 EYUK2451 EYUL2443 EYUL2450 EYUL2451
  EYUP2443 EYUP2450 EYUP2451 EYUQXXRC EYUQXZXD EYURXZXD EYUR2443
  EYUR2450 EYUR2451 EYUSA00D EYUSA1W2 EYUSA1W3 EYUS2443 EYUS2450
  EYUS2451 EYUTMOMI EYUTMOSD EYUTRDIR EYUTRTRC EYUTVOSX EYUT2443
  EYUT2450 EYUT2451 EYUUXXFI EYUUXXRS EYUUXXTC EYUYXZXD EYUY2443
  EYUY2450 EYUY2451 EYUZXZXD EYU0XZSD EYU0XZXD EYU9XLMC EYU9XZPU
  EYU9XZP3 EYU9XZP4 EYU9XZP6 JCI660MJ MAS
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60M PSY UK59233

     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.