A fix is available
APAR status
Closed as program error.
Error description
You are running CICS transaction server, using DB2and your application is receiving AD3F abends. In the message log you receive the following error messages: . DFHAP0002 A severe error (code X'3255') has occurred in module DFHD2D2. DFHDS0002 A severe error (code X'0204') has occurred in module DFHDSTCB. followed by a kernel dump: DFHKE0201 ABOUT TO TAKE SDUMP. DUMPCODE: KERNDUMP, DUMPID:0/0000. (MODULE DFHKEDD ). . Here are some DB2 exception traces from the dump: AP 3255 D2D2 *EXC* - INVALID_TCB FUNCTION(DB2_API_CALL) AP 3269 D2D2 *EXC* - FAILED_TO_TERMINATE_THREAD_FOR_PLAN AP 318E D2EX1 *EXC* - RECOVERY_ROUTINE_ENTERED (AD3F abend) . Looking a the CSUB for the task involved, I see DB2 error 00F31107- indicating DB2 encountered a logic error while processing an internal program request. . Here are some of the dispatcher exceptions: DS 0204 DSTCB *EXC* - DSTCB_INVALID_ABTERM DS 0157 DSSR *EXC* - DSSR_ILLEGAL_ENVIRONMENT_1 . This APAR is similar to PI23186, except it is a user task attempting to use a protected thread that was canceled in DB2. Additional Symptom(s) Search Keyword(s): KIXREVEPH ABENDAD3F
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS Users. * **************************************************************** * PROBLEM DESCRIPTION: Application receives an abend AD3F * * which is followed by msgDFHAP0002 and * * msgDFHDS0002. * **************************************************************** * RECOMMENDATION: * **************************************************************** A CICS DB2 transaction has been defined to use protected threads. An instance of this transaction completes and its thread is then protected ready for reuse. However this thread is being CANCELed in DB2. When the thread does not get reused for the defined purge cycle time then CICS will attempt to terminate it. DFHD2EX2 will call DFHD2D2 to issue an ASSOciate, but this is failing with a DB2 feedback code of x'00F31107' because DB2 no longer knows about it. The next CICS transaction that attempts to use this thread will suffer the abendAD3F. Keywords: CEX2 DFHD2EX2
Problem conclusion
DFHD2D2 has been changed to clean up the thread correctly following a feedback code of '00F31107'x.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PI39818
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
800
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2015-04-24
Closed date
2015-06-01
Last modified date
2015-07-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI28203 UI28204
Modules/Macros
DFHD2D2
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
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":"5.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":"5.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 July 2015