IBM Support

PM58270: SERVICEABILITY APAR TO IMPROVE AD2R AND CSUB ABEND INFORMATION

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • AD2R and CSUB abend information is incomplete.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: A CICS-DB2 subtask abends.  Exception   *
    *                      trace AP 319D is written which          *
    *                      contains fields CSB_SDWA_REGS and       *
    *                      CSB_SDWA_PSW however their offset is    *
    *                      not apparent or documented.             *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    In the event of a CICS-DB2 subtask abend, the recovery process
    includes saving information from the MVS SDWA in the CSUB
    control block.  This includes fields CSB_SDWA_REGS and
    CSB_SDWA_PSW.  The CSUB control block containing the SDWA
    information is then included in the AP 319D exception trace
    written as a result of the abend.  There is no eye catcher to
    identify fields CSB_SDWA_REGS and CSB_SDWA_PSW within the
    CSUB however.
    Additional keywords: abendAD2R AD2R DFHD2CSB
    

Problem conclusion

  • A new SDWA eyecatcher has been added to the CSUB control block
    which immediately preceeds the CSB_SDWA_REGS and CSB_SDWA_PSW
    fields.
    
    The CICS Transaction Server for z/OS Version 4 Release 2 CICS
    Messages and Code Vol 1 manual (GC34-7175-01), will be updated
    as follows.
    
    In Chapter 2. Transaction abend codes, the explanation of abend
    AD2R will be modified to read:
    
    The CICS-DB2 attached TCB connection that processes the DB2
    request for this transaction has abended.  An exception trace,
    AP 319D, is written containing the MVS abend code; MVS reason
    code; and the relevant CICS-DB2 control blocks that are used by
    the CICS task and by the CICS-DB2 TCB connection. One of the
    control blocks returned is the CSUB control block.  This
    control block contains data from the MVS SDWA at the time of
    the abend, for example, the CSB_SDWA_REGS (regs 0 -15) and the
    CSB_SDWA_PSW fields.  The CSB_SDWA_REGS is the 16 words
    following the SDWA eye catcher.  The CSB_SDWA_PSW field is the
    two words following the CSB_SDWA_REGS field. The TCB connection
    is terminated if a CICS transaction is forcepurged from CICS
    when the thread is still active in DB2.
    
    Additionally, the CICS Transaction Server for z/OS Version 4
    Release 2 DB2 Guide manual (SC34-7164-01), will be updated as
    follows.
    
    In Chapter 11. Problem determination for CICS DB2, section CSUB
    Abend information, will be modified to read:
    
    If a CICS-DB2 subtask abends, as part of the recovery process
    CICS saves information from the MVS SDWA in the CSUB control
    block. For example, the CSB_SDWA_REGS (regs 0 -15) and the
    CSB_SDWA_PSW fields.  The CSB_SDWA_REGS is the 16 words
    following the SDWA eye catcher.  The CSB_SDWA_PSW field is the
    two words following the CSB_SDWA_REGS field.  Although the CSUB
    is typically cleared by the FREEMAIN function following the
    failure, the exception trace written at the time of failure, AP
    319D, captures the CSUB control block containing the SDWA
    information.
    
    Figure 45. Sample CSUB trace - CICS connected to DB2, will have
    line 0200 updated as follows, to show the position of the new
    eye catcher:
    
    0200  00000000 00000000 E2C4E6C1 201B7000  213C2C58 21414030
    20BF8700 213C28C8  *........SDWA.......... ...g....H*
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM58270

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    700

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / Serviceability

  • Submitted date

    2012-02-16

  • Closed date

    2012-05-22

  • Last modified date

    2012-06-03

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

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

    UK78972

Modules/Macros

  •    DFHDSMT  DFHD2CC  DFHD2CO  DFHD2DUF DFHD2D2
    DFHD2EX1 DFHD2EX2 DFHD2EX3 DFHD2MSB DFHD2RP  DFHD2STP DFHD2STR
    DFHD2TM
    

Publications Referenced
GC34717501SC34716401   

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R700 PSY UK78972

       UP12/06/01 P F205

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":"4.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":"4.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 June 2012