IBM Support

PM95250: DFHDS0002 A SEVERE ERROR (CODE X'0056') HAS OCCURRED IN MODULE DFHDSKE.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • The problem is occurring during the processing of the DELAY
    request. We can see that after the DELAY, the CHANGE_MODE from
    the L8 to the QR happens because the exit program running is
    not threadsafe. As soon as we have the UEH return from the exit
    program, DFHUEH switches back to the L8, eventhough the program
    that issued the Delay is threadsafe:
    
    55555 L803P DS 0003 DSAT  EXIT  CHANGE_MODE/OK
    DSTCB QR    DS 0042 DSTCB EVENT TRACE_DOUBLE_CHAIN_GET
    55555 L803P AP 00F3 ICP   ENTRY WAIT
    00007 QR    DS 0005 DSSR  EXIT  SUSPEND/OK
    00007 QR    AP 00F3 ICP   ENTRY ICE            EXPIRY ANALYSIS
    55555 L803P TI 0100 TISR  ENTRY REQUEST_NOTIFY_INTERVAL
    00007 QR    DS 0004 DSSR ENTRY RESUME
    55555 L803P TI 0101 TISR  EXIT  REQUEST_NOTIFY_INTERVAL/OK
    00007 QR    DS 0005 DSSR  EXIT  RESUME/OK
    00007 QR    TI 0100 TISR  ENTRY CANCEL
    00007 QR    TI 0101 TISR  EXIT  CANCEL/OK
    55555 L803P DS 0002 DSAT  ENTRY CHANGE_PRIORITY
    
    After DFHUEH issues the CHANGE_MODE back to the L8, DFHEIIC
    calls DFHICP to wait the task. The 55555 task issues it's
    REQUEST_NOTIFY_INTERVAL but meanwhile the APTIX task (task # 7)
    is racing on the QR TCB and issues the RESUME for 59449 before
    DFHICP issues the CHANGE_PRIORITY.
    
    The ENTRY WAIT trace entry shows The wait time requested is
    x'0000000F' - an unsigned packed decimal zero. There is code in
    DFHEIIC which is intended to
    prevent DFHICP from being called for a wait time of zero, but
    it tests for x'0000000C' . These values don't match so we
    mistakenly call DFHICP on the L8.
    
    
    
    
    
    
    
    
    Additional Symptom(s) Search Keyword(s): KIXREVxxx
    

Local fix

  • N/A
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All.                                         *
    ****************************************************************
    * PROBLEM DESCRIPTION: During task termination, a task issues  *
    *                      exception trace entry DS 0056           *
    *                      DSKE_TASK_SUSP_TOK_IN_USE. CICS         *
    *                      Terminates with message DFHDS0002.      *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    A task issues an EXEC CICS DELAY on an open TCB. The INTERVAL
    keyword is specified, which takes an argument in packed decimal
    format. The value supplied is '0000000F', which represents an
    unsigned zero.
    This causes CICS to conduct interval control WAIT processing,
    even though this should not be needed for an interval of zero
    seconds. No TCB switch takes place; this task remains running on
    an open TCB.
    Meanwhile, the system APTIX task runs DFHICP on the QR TCB. As
    this code is not threadsafe, this situation allows the two tasks
    to interleave.
    There are two known symptoms to this interleaving.
    In the reported problem, APTIX issues a RESUME for the task that
    issued the DELAY. There is no corresponding SUSPEND. This causes
    the task to enter a state which, at task termination, is
    determined to be invalid. This leads to message
    DFHDS0002 A SEVERE ERROR (CODE X'0056') HAS OCCURRED IN MODULE
    DFHDSKE
    .
    In another instance of this problem, the interleaving caused
    corruption of the APICE31 storage subpool. This is used to
    satisfy GETMAINs for ICE control blocks. This resulted in an
    invalid QPH, which appeared to have one free element in the
    pool, but with a next free element address of zeros. The
    following message was issued:
    DFHSM0002 SEVERE ERROR (CODE X'030D') HAS OCCURRED IN MODULE
    DFHSMGF
    .
    Additional Keywords: DS0002 SM0002 030D 0056 msgDFHDS0002
                         msgDFHSM0002
    

Problem conclusion

  • DFHEIIC has been corrected such that DFHICP is not called when
    the interval specified is zero, regardless of the sign nibble in
    the packed decimal argument.
    

Temporary fix

  • *********
                * HIPER *
                *********
    FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM95250

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-08-16

  • Closed date

    2013-09-17

  • Last modified date

    2015-03-04

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

    PM94406

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

    UK97728

Modules/Macros

  • DFHEIIC
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R800 PSY UK97728

       UP13/09/28 P F309

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:
04 March 2015