PI61811: DFHNQ0002 SEVERE ERROR (CODE X'0215') AFTER ENQUEUE EXECSTRN

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• DFHNQ0002 A SEVERE ERROR (CODE X'0215') HAS OCCURRED IN
  MODULE DFHNQED.
  .
  The problem occurs very early during initialization of a CICS
  task. The Kernel stacks for the task show module DFHXMTA is
  calling the various domains needed to run the task. DFHXMTA
  calls DFHMRXM for INIT_XM_CLIENT and during this processing an
  abend occurs. During abend processing, a GLUE at exit point
  XPCTA issues an XPI ENQUEUE specifying ENQUEUE_TYPE(EXECSTRN).
  This causes the enqueue to be created in the EXECSTRN pool
  which by default, is associated with a UOW.
  .
  As a result, DFHNQNQ needs to add the new NQEA to the UOW's
  ownership chain and issues an INQUIRE_WORK_TOKEN call. But this
  processing all occurs before the UOW has been set up for the
  new task. So the INQUIRE_WORK_TOKEN call fails, and the
  DFHNQNQ 0215 error is issued.
  .
  Note that the ENQ is issued with ENQUEUE_TYPE(EXECSTRN)
  which causes the ENQUEUE to be associated with a UOW. If the
  XPCTA user exit used ENQUEUE_TYPE(XPI) or removed the EXECSTRN
  parameter, the NQ failure would not occur.
  .
  Additional Symptom(s) Search Keyword(s): KIXREVSCB
  DFHNQNQ NQEA INQUIRE_WORK_TOKEN CREATE_UOW NQ0002
  tid_nqnq_inquire_uow_failure Inquire_UOW_failure EXECSTRN XPI
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHNQ0002 issued when an ENQUEUE of     *
  *                      ENQUEUE_TYPE(EXECSTRN) is unavailable.  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This problem presented in the following manner:
                                                                 .
  An EXIT was active at EXIT point XPCTA, this exit is invoked
  immediately after a transaction abend. The exit contained an
                                                                 .
  DFHNQEDX CALL, FUNCTION(ENQUEUE), ENQUEUE_TYPE(EXECSTRN).
                                                                 .
  A transaction ran but it abended very early in initialisation
  and control was passed to the aforementioned EXIT program.
                                                                 .
  The EXIT attempted the DFHNQEDX call but this failed with an
  DFHNQ0002 severe error message being issued.
                                                                 .
  An ENQUEUE_TYPE of EXECSTRN means the ENQ must be built from the
  same UOW pool as the transaction it is invoked for.  However,
  because the transaction abended so early in transaction
  initialisation, its UOW pool had not yet been set up for use.
  In this instance, a softer response would be better suited.
                                                                 .
  Keywords: NQ0002 0215 msgDFHNQ0002 invalid_phase
  

Problem conclusion

• DFHNQNQ has been modified and will now set an invalid_phase
  response rather than an DFHNQ0002 severe error.
  
  The CICS Transaction Server for z/OS 5.2 Customization Guide
  (SC34-7269-00) will have the following update:
                                                                 .
  In the section titled 'Enqueue domain XPI functions', the
  table for RESPONSE and REASON values for ENQUEUE will now
  read:
                                                                 .
    RESPONSE      REASON
    OK            None
    EXCEPTION
                  ENQUEUE_BUSY
                  ENQUEUE_LOCKED
                  ENQUEUE_DISABLED
                  LIMIT_EXCEEDED
                  SYSENQ_FAILURE
  |               INVALID_PHASE
    PURGED
                  TASK_CANCELLED
                  TIMED_OUT
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  PI66018 UI39877

Modules/Macros

• DFHNQED
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R900 PSY UI39877

     UP16/08/11 P F608

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.