A fix is available
APAR status
Closed as program error.
Error description
A CICS transaction accessing DB2 suffered an abendASP1: Messages log shows : DFHAC2231 date time applid Transaction tranid running program program name term termid has lost contact with its coordinator system during syncpoint and has abended with code ASP1 . DFHRM0106 12/11/2008 12:15:27 applid Intersystem communication failure. . DFHAC2236 12/11/2008 12:16:10 applid Transaction tttt abend AZI2 in program ppppp term <yyy. Updates to local resources will be backed out. CEE3250C The system or user abend AD3L was issued. DFHAC2236 12/11/2008 12:16:10 applid Transaction tttt abend AD3L in program DFHD2EX1 term <zzz. . A CICS system dump for the abendAD3L showed that DB2 was issuing abend04e. A SLIP trap on the ABEND04E showed that DB2 was issuing this abend with return code 00F31102 is generated in DSNAPRHX and means invalid token in the ASSOCIATE request. This ASSOCIATE request was invalid since DB2 had already terminated it's AGENT linked to this ASSOCIATE token. . It seems that DB2 terminated the agent as the result of CICS issuing a RESOLVE_INDOUBT to DB2 caused by the abendASP1.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All * **************************************************************** * PROBLEM DESCRIPTION: Unnecessary resync call to DB2 leads to * * a subsequent abend AD3L. * **************************************************************** * RECOMMENDATION: * **************************************************************** A CICS transaction reaches syncpoint. It polls DB2, which votes readonly with respect to the UOW. It then suffers a failure further in the prepare logic, for another RMC. This causes the UOW to be shunted, and the associated task to abend with an ASP1 abend code. When the problem is resolved and the UOW subsequently unshunts, DFHERMSP calls DFHD2EX1 even though DB2 had no interest in the UOW's resolution. This results in DB2 terminating its AGENT linked to the associated ASSOCIATE token. When a task issues a subsequent SQL request, and happens to reuse the CSUB from the earlier task (which is on the protected free chain), this leads to an abend 04E from DB2 and an abend AD3L for the task. KEYWORDS: abendasp1 abendad3l abend04E rc00F31102 free freed AGNT block and resolve indoubt
Problem conclusion
DFHD2EX1 and DFHERMSP have been changed to remember that DB2 has voted read only on its prepare call. This means that CICS will discard the rmlk object from the UOW's linkset, if the UOW subsequently has to be shunted. By doing this, CICS will avoid calling DFHERMSP for DB2 unshunt processing later on as the link is no longer associated with the UOW. The CICS Transaction Server V3.1 Data Areas manual (GC34-6902-00) will be updated. The description of the TIE DSECT on page 486 will change, to define new field TIEMRORM as the 5th bit in byte TIEFLAG3 at x73 into the TIE: '.... 1... TIEMRORM Avoid unshunting (r/o RMC)' . The CICS Transaction Server V3.2 Data Areas manual (GC34-6863-00) will be updated. The description of the TIE DSECT on page 1192 will change, to define new field TIEMRORM as the 5th bit in byte TIEFLAG3 at x73 into the TIE: '.... 1... TIEMRORM Avoid unshunting (r/o RMC)'
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK82612
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
400
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2009-03-17
Closed date
2009-06-25
Last modified date
2009-08-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PK88862 UK47753 UK47757
Modules/Macros
DESD2EX1 DESERMSP DFHD2EX1 DFHERMSP DFHTIEDS DFHTIEPS
GC34690200 | GC34686300 |
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
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"}},{"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.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
03 August 2009