A fix is available
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
GC34717501 | SC34716401 |
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