IBM Support

PM56390: DFHNQ0002 SEVERE ERROR (CODE X'030B') HAS OCCURRED IN DFHNQED

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Your CICS region issues message:
    .
    DFHNQ0002 A severe error (code X'030B') has occurred in module
      DFHNQED.
    .
    The failing task has issued a SYSPLEX ENQUEUE. The problem
    occurs in DFHNQED's SYSPLEX_ENQUEUE_WAITER proc due to DFHDSSRM
    and DFHLMLMM macros using the same area to address their parm
    lists.
    .
    When the SYSPLEX ENQ is not available,  there is a loop which
    suspends the task, resuming every quarter of a second to
    reissue the MVS ENQ request. The NQ domain lock is released
    around this request. The problem occurs when we exit the loop
    for DTIMOUT reasons. DFHNQED attempts to reacquire the NQ lock
    with a compare and swap instruction, but if that doesn't work,
    the code issues a DFHLMLMM call to get the lock. But the lock
    manager call uses the same area in the stack as the DFHDSSRM
    macro. When the lock manager call returns to DFHNQED, there
    is now a successful return code in the lock manager parm list.
    So when DFHNQED checks the DSSR return code, there is no longer
    a timed-out response but a normal return and we end up in the
    path for the resumed_and_not_owner_logic_error.
    .
    Additional Symptom(s) Search Keyword(s):
    KIXREVrer   Waiter_not_enqueue_owner_after_resume  EXECPLEX
    SYSPLEX_ENQUEUE
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All                                          *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHNQ0002 severe error x'030B' occurred *
    *                      in DFHNQED.                             *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    When a sysplex enq is not available, DFHNQED suspends the task,
    resuming it every quarter of a second to reissue the MVS ENQ
    request. The NQ domain lock is released around this request. If
    the suspended task times out waiting for the enq, DFHNQED
    attempts to reacquire the NQ domain lock with a direct compare
    and swap call on the lm_lock_owner field. If this fails, a
    DFHLMLMM call is made to get the lock. However, DFHNQED shares
    the same parameter list storage area for both dssr and lmlm
    calls. This means the dssr_response of purged with a reason of
    timed out is lost, and replaced by an lmlm_response of normal.
    This drives the resumed_and_not_owner_logic_error path, and
    DFHNQ0002 is issued in error.
    MSGDFHNQ0002 NQ0002 0002 nqed
    

Problem conclusion

  • DFHNQED has been changed to separate the paramater lists
    declarations.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM56390

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    600

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-01-19

  • Closed date

    2012-04-24

  • Last modified date

    2012-05-02

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

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

    UK78217 UK78218

Modules/Macros

  •    DESNQNQ  DFHNQED
    

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R600 PSY UK78217

       UP12/04/27 P F204

  • R700 PSY UK78218

       UP12/04/27 P F204

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":"4.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":"4.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
02 May 2012