IBM Support

PI39818: APPLICATION RECEIVES AD3F ABEND AND MESSAGES DFHAP0002 3255 AND DFHDS002 0204 ISSUED, FOLLOWED BY KERNDUMP

A fix is available

Subscribe

You can track all active APARs for this component.

 

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:

    PI38802

  • 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

  • R800 PSY UI28203

       UP15/06/11 P F506

  • R900 PSY UI28204

       UP15/06/11 P F506

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