A fix is available
APAR status
Closed as program error.
Error description
APAR to add a new EYUPARM option for ESDUMP called NEVER. I this is specified in a CMAS or MAS, we will never take an SVCdump through our normal recovery (EYU9XLRV), through the trace ESDMP option (EYU0XZPT), or when we call EYU0XZSD to a dump. We will still allow a dump to be taken when EYU0XZSD is called through our debugger. The down side of specifying ESDUMP=NEVER will be that if a problem occurs and we suppress a dump, the site may be required to reproduce the problem with ESDUMPᆰ=NEVER for us to be able to work on the problem.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: SVC dumps taken by EYU9XLRV, EYU0XZPT, * * or EYU0XZSD cannot be suppressed. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes and MASes must be * * restarted. Note that the restarts do not * * need to occur at the same time. * * * * This APAR allows users the ability to * * suppress SVC dumps taken by EYU9XLRV, * * EYU0XZPT, and EYU0XZSD. It is strongly * * recommended by CPSM service that this * * feature not be used, as it may affect the * * ability to debug problems. If a problem * * occurs with SVC dump suppression active, * * users may be required to reproduce the * * problem without SVC dump suppression active * * before debugging can be performed for the * * problem. * **************************************************************** A facility is required to allow users the ability to suppress SVC dumps taken by CPSM for abend recovery (EYU9XLRV) or for internal on demand requests (EYU0XZPT or EYU0XZSD).
Problem conclusion
The CPSM EYUPARM ESDUMP has been updated to allow new value NEVER. If ESDUMP(NEVER) is specified, SVC dumps taken by EYU9XLEV, EYU0XZPT, or internally by EYU0XZSD will be suppressed. SVC dump requests through EYU0XZSD from the COD0 transaction will continue to be honored. While this ability is being given to users, it is strongly recommended that it not be used, as it may affect the ability of CPSM service to debug problems. If ESDUMP(NEVER) is used, users may be required to reproduce problems without ESDUMP(NEVER) before debugging can be performed. To allow disabling of SVC dump suppression without restarting the CMAS or MAS, the ESDUMP value can also be updated as follows: - through the COD0 SET command. - for a CMAS only, by updating the CMAS resource table SDUMP field through the EUI ( CMASD view "SDUMP always" field), or through the API or WUI. When SVC dump suppression is activated through EYUPARM, COD0, or update to the CMAS resource table SDUMP field, new message EYUXL0077W will be issued: EYUXL0077W No SVC dumps will be taken because ESDUMP has been set to NEVER through <EYUPARM|COD0|CMAS resource table> When SVC dump suppression is deactivated through COD0 or update to the CMAS resource table SDUMP field, new message EYUXL0029I will be issued: EYUXL0029I ESDUMP value set to <YES|NO> through <COD0|CMAS resource table> When an SVC dump is suppressed by EYU9XLRV, new message EYUXL0911W will be issued: EYUXL0911W EYU9XLRV dump suppressed because ESDUMP is set to NEVER When an SVC dump is suppressed by EYU0XZPT or EYU0XZSD, new message EYUXZ0911W will be issued: EYUXZ0911W <EYU0XZPT|EYU0XZSD> dump suppressed because ESDUMP is set to NEVER The following updates were made to affect these changes: - The CMAS resource table was updated to allow a value of NEVER for the SDUMP field. - The EUI CMASD view and field help were updated to indicate that NEVER is a valid value for the "SDUMP always" field. - The WUI EYUSTARTCMAS view set was updated to display NEVER as a valid value in the CMAS resource table SDUMP field drop down list. - The CPSM Kernel (KNL) component anchor block, EYURXLWA, has been updated to contain a flag value to indicate that SVC dump suppression is active. - The CPSM Kernel (KNL) component message table, EYUTXLM0, has been updated to add message prototypes for new messages EYUXL0029I and EYUXL0077W. - The parameter services table, EYUTXLPD, has been updated to allow NEVER as a valid setting for EYUPARM ESDUMP. - Copybook EYU0DSET, which is included in the assembly of the COD0 transaction processing module EYU9DBG1, has been updated to allow the SET command to modify the ESDUMP EYUPARM, set the correct flag bit setting in the EYURXLWA, and issue message EYUXL0029I or EYUXL0077W. - Method EYU0XLAC (XLAC), which is called to build the CMAS resource table when requested through the EUI, API, or WUI, has been updated to set the value for the SDUMP field to NEVER if the EYURXLWA SVC dump suppression flag bit is on. - Method EYU0XLAU (XLAU), which is called to update the CMAS resource table when requested through the EUI, API, or WUI, has been updated to accept a value of NEVER for the SDUMP field. If NEVER is specified, XLAU will update the ESDUMP EYUPARM, set the correct flag bit setting in the EYURXLWA, and issue message EYUXL0029I or EYUXL0077W. - Method EYU0XLBV (XLBV), which processes the ESDUMP EYUPARM during CMAS and MAS initialization, has been updated to turn on the EYURXLWA SVC dump suppression flag bit and issue message EYUXL0077W if the value of ESDUMP is NEVER. - Methods EYU0XZPT (XZPT) and EYU0XZSD (XZSD) have been updated to check the EYURXLWA SVC dump suppression flag when they are called to issue an on demand SVC dump. If the flag is on, they will issue message EYUXZ0911W and suppress the dump. - Module EYU9XLRV has been updated to check the EYURXLWA SVC dump suppression flag when called to issue an SVC dump during abend recovery. If the flag is on, EYU9XLRV will issue message EYUXL0911W and suppress the dump.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
SVC dumps taken by EYU9XLRV, EYU0XZPT, or EYU0XZSD cannot be suppressed. A facility is required to allow users the ability to suppress SVC dumps taken by CPSM for abend recovery (EYU9XLRV) or for internal on demand requests (EYU0XZPT or EYU0XZSD). The CPSM EYUPARM ESDUMP has been updated to allow new value NEVER. If ESDUMP(NEVER) is specified, SVC dumps taken by EYU9XLEV, EYU0XZPT, or internally by EYU0XZSD will be suppressed. SVC dump requests through EYU0XZSD from the COD0 transaction will continue to be honored. While this ability is being given to users, it is strongly recommended that it not be used, as it may affect the ability of CPSM service to debug problems. If ESDUMP(NEVER) is used, users may be required to reproduce problems without ESDUMP(NEVER) before debugging can be performed. To allow disabling of SVC dump suppression without restarting the CMAS or MAS, the ESDUMP value can also be updated as follows: - through the COD0 SET command. - for a CMAS only, by updating the CMAS resource table SDUMP field through the EUI ( CMASD view "SDUMP always" field), or through the API or WUI. When SVC dump suppression is activated through EYUPARM, COD0, or update to the CMAS resource table SDUMP field, new message EYUXL0077W will be issued: EYUXL0077W No SVC dumps will be taken because ESDUMP has been set to NEVER through <EYUPARM|COD0|CMAS resource table> When SVC dump suppression is deactivated through COD0 or update to the CMAS resource table SDUMP field, new message EYUXL0029I will be issued: EYUXL0029I ESDUMP value set to <YES|NO> through <COD0|CMAS resource table> When an SVC dump is suppressed by EYU9XLRV, new message EYUXL0911W will be issued: EYUXL0911W EYU9XLRV dump suppressed because ESDUMP is set to NEVER When an SVC dump is suppressed by EYU0XZPT or EYU0XZSD, new message EYUXZ0911W will be issued: EYUXZ0911W <EYU0XZPT|EYU0XZSD> dump suppressed because ESDUMP is set to NEVER The following updates were made to affect these changes: - The CMAS resource table was updated to allow a value of NEVER for the SDUMP field. - The EUI CMASD view and field help were updated to indicate that NEVER is a valid value for the "SDUMP always" field. - The WUI EYUSTARTCMAS view set was updated to display NEVER as a valid value in the CMAS resource table SDUMP field drop down list. - The CPSM Kernel (KNL) component anchor block, EYURXLWA, has been updated to contain a flag value to indicate that SVC dump suppression is active. - The CPSM Kernel (KNL) component message table, EYUTXLM0, has been updated to add message prototypes for new messages EYUXL0029I and EYUXL0077W. - The parameter services table, EYUTXLPD, has been updated to allow NEVER as a valid setting for EYUPARM ESDUMP. - Copybook EYU0DSET, which is included in the assembly of the COD0 transaction processing module EYU9DBG1, has been updated to allow the SET command to modify the ESDUMP EYUPARM, set the correct flag bit setting in the EYURXLWA, and issue message EYUXL0029I or EYUXL0077W. - Method EYU0XLAC (XLAC), which is called to build the CMAS resource table when requested through the EUI, API, or WUI, has been updated to set the value for the SDUMP field to NEVER if the EYURXLWA SVC dump suppression flag bit is on. - Method EYU0XLAU (XLAU), which is called to update the CMAS resource table when requested through the EUI, API, or WUI, has been updated to accept a value of NEVER for the SDUMP field. If NEVER is specified, XLAU will update the ESDUMP EYUPARM, set the correct flag bit setting in the EYURXLWA, and issue message EYUXL0029I or EYUXL0077W. - Method EYU0XLBV (XLBV), which processes the ESDUMP EYUPARM during CMAS and MAS initialization, has been updated to turn on the EYURXLWA SVC dump suppression flag bit and issue message EYUXL0077W if the value of ESDUMP is NEVER. - Methods EYU0XZPT (XZPT) and EYU0XZSD (XZSD) have been updated to check the EYURXLWA SVC dump suppression flag when they are called to issue an on demand SVC dump. If the flag is on, they will issue message EYUXZ0911W and suppress the dump. - Module EYU9XLRV has been updated to check the EYURXLWA SVC dump suppression flag when called to issue an SVC dump during abend recovery. If the flag is on, EYU9XLRV will issue message EYUXL0911W and suppress the dump.
APAR Information
APAR number
PK19668
Reported component name
CPSM CICS 3.1
Reported component ID
5655M1501
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2006-02-13
Closed date
2006-06-28
Last modified date
2007-01-31
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK15845 PK38466
Modules/Macros
CMAS CMASD EYUA2451 EYUC2451 EYUEVX01 EYUE2451 EYUKVX01 EYUK2451 EYUL2451 EYUMEGE0 EYUN2451 EYUP2451 EYURXLWA EYUR2451 EYUSVX01 EYUS2451 EYUTXLM0 EYUTXLPD EYUTXZM0 EYUT2451 EYUUXLEQ EYUUXZEQ EYUWEGE0 EYUXEGE0 EYUY2451 EYUZEGE0 EYU0DSET EYU0XLAC EYU0XLAU EYU0XLBV EYU0XZPT EYU0XZSD EYU5EGE0 EYU8EGE0 EYU9DBG1 EYU9XLRV
GC34647201 | SC34647003 | GC34647102 |
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK15845
UP06/06/30 P F606
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.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
22 February 2023