A fix is available
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 V3R2M0 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 * * V4.1, the PTFs which resolve the following * * APARs must be applied to allow dumps to be * * requested of CMASes executing other CPSM * * releases. * * * * - CTS 3.1 - CPSM 3.1.0 - APAR PK87714 * * - CTS 4.1 - CPSM 4.1.0 - APAR PK87713 * * * * 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 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. * * * * In addition, you must re-import the updated * * starter set viewset and menu definitions * * 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 view- * * sets and menus. * * * * Users who have copied the IBM supplied * * starter set viewsets and menus to another * * name will have to manually apply the changes * * made by the PTF that resolves this APAR to * * those copies. * * * * For details on the AUTOIMPORTDSN and * * AUTOIMPORTMEM WUI server initialization * * parameters see 'Specify the Web User Inter- * * face server initialization parameters' in * * CICS Transaction Server for z/OS Version 3 * * Release 2 Installation Guide (GC34-6812). * * * * For details on the COVC IMPORT function see * * 'The CICSPlex SM Web User Interface trans- * * action (COVC)' in CICS Transaction Server * * for z/OS Version 3 Release 2 CICSPlex SM * * Web User Interface Guide (SC34-6841). * * * * The updated starter set member names that * * need to be imported are: * * * * Viewsets : * * 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. 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 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. 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
PK87706
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
50M
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:
APAR is sysrouted TO one or more of the following:
Modules/Macros
CMAS CMASLIST EYUA2443 EYUA2450 EYUA2451 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 EYU0XL80 EYU0XZSD EYU0XZXD EYU9XLMC EYU9XZPU EYU9XZP3 EYU9XZP4 EYU9XZP5 JCI650MJ MAS
SC34685000 | GC34685200 | SC34684200 |
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R50M PSY UK59234
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.
[{"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.2","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":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 August 2010