IBM Support

PK19668: ADD A NEW EYUPARM OPTION FOR ESDUMP CALLED NEVER TO ALLOW NO SVCDUMP THROUGH OUR NORMAL RECOVERY (EYU9XLRV) IN CMAS OR MAS

A fix is available

Subscribe

You can track all active APARs for this component.

 

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
    

Publications Referenced
GC34647201SC34647003GC34647102  

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