IBM Support

PI46189: DFHAP0002 CODE 1953 RECEIVED DURING SHUTDOWN.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • During shutdown of CICS, you receive message DFHAP0002 A
    SEVERE ERROR (CODE X'1953') HAS OCCURRED IN MODULE DFHAPLI3.
    .
    Here is the message in context with other messages during
    shutdown:
    .
    20.16.13 DFHTM1782I CICSXYZ ALL NON-SYSTEM TASKS HAVE BEEN
    SUCCESSFULLY TERMINATED.
    20.16.13 DFHZC2305I CICSXYZ TERMINATION OF VTAM SESSIONS
    BEGINNING
    20.16.15 DFHZC2316 CICSXYZ VTAM ACB IS CLOSED
    20.16.15 DFHCQ0104I CICSXYZ MVS CONSOLE QUEUE IS CLOSED.
    20.16.19 DFHRM0131 CICSXYZ RESYNCHRONIZATION REQUIRED WITH IRC
    RESOURCES.
    20.16.31 DFHRM0204 CICSXYZ THERE ARE NO INDOUBT, COMMIT-FAILED
    OR BACKOUT-FAILED UOWS.
    20.16.32 DFHAP0002 CICSXYZ A SEVERE ERROR (CODE X'1953') HAS
    OCCURRED IN MODULE DFHAPLI3.
    20.16.32 DFHDU0201 CICSXYZ  ABOUT TO TAKE SDUMP. DUMPCODE:
    AP0002  , DUMPID: 23/0001
    20.16.34 DFHDU0202 CICSXYZ  SDUMPX COMPLETE. SDUMPX RETURN CODE
    X'00'
    20.16.34 DFHRM0130 CICSXYZ RECOVERY MANAGER HAS SUCCESSFULLY
    QUIESCED.
    20.16.35 DFHDU0303I CICSXYZ TRANSACTION DUMP DATA SET DFHDMPA
    CLOSED.
    20.16.35 DFHKE1799 CICSXYZ  TERMINATION OF CICS IS COMPLETE.
    .
    You get this problem on a CICS region that receives ECI over
    TCPIP requests.  For each such request, CICS attaches a CIEP
    transaction.  If that happens late enough during shutdown, the
    problem happens.
    
    
    
    
    Additional Symptom(s) Search Keyword(s): KIXREVDWZ
    

Local fix

  • Stop all ECI requests from arriving in the CICS region before
    shutting it down.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All.                                         *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHAP0002 during shutdown.              *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    In the reported problem, CICS had an open TCPIPSERVICE with
    PROTOCOL(ECI) - External Call Interface.  CICS was shutting
    down but received an ECI request from CTG ( CICS Transaction
    Gateway ).  This caused an attach of transaction CIEP which
    uses program DFHIEP.  However, DFHIEP was not loaded, it had
    been unloaded due to program compression.  The AP domain
    attempted to load DFHIEP and then called LE to perform
    establish_language processing.  However, DFHSTP had already
    terminated LE and the services it provided were no longer
    available.
    As a consequence, a DFHAP0002 SEVERE ERROR (CODE X'1953')
    message was issued.
                                                                   .
    Keywords: msgDFHAP0002 AP0002
    

Problem conclusion

  • DFHSTP has been modified, it will now preload DFHIEP prior to
    LE being terminated.  Should DFHIEP be required, CICS will not
    call LE services thus precluding the DFHAP0002 message.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PI46189

  • 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-08-03

  • Closed date

    2015-09-22

  • Last modified date

    2015-10-02

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

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

    UI31397 UI31398

Modules/Macros

  • DFHSTP
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R800 PSY UI31397

       UP15/10/01 P F509

  • R900 PSY UI31398

       UP15/10/01 P F509

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:
02 October 2015