PI26932: DFHMQ0309. UNABLE TO DISCONNECT MQ CICS ADAPTER IF CICS BEGAN CONNECTING WHILE MQ SHUTTING DOWN

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Your CICS region MQ Adapter begins to connect to MQ. Between
  the time it identifies itself to MQ and the time it establishes
  an exit for itself, MQ begins to shut down.
  The request to establish itself is successful, but the request
  to establish the exit fails with MQ RC=2162. A DFHMQ0309
  message is issued.
  At this point, MQ can not complete its shutdown because CICS is
  partially connected. CICS is also unable to disconnect.
  .
  Additional Symptom(s) Search Keyword(s): KIXREVRJL
  

Local fix

• Cycle CICS
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: A CICS region attempts to connect to a  *
  *                      WMQ Queue Manager (QMGR) address space  *
  *                      just as the QMGR begins to shutdown.    *
  *                      This leads to CICS issuing message      *
  *                      'DFHMQ0309E Unable to connect using     *
  *                      MQNAME QMGR. MQCC=2 MQRC=2162' and      *
  *                      the QMGR shutdown hangs.                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A CICS system attempting to connect to a WMQ QMGR successfully
  issues an IDENTIFY call to WMQ but, simultaneously, the QMGR
  begins to shutdown. This leads to the subsequent ESTABLISH EXIT
  call to WMQ failing with MQRC=2162 (Queue Manager Stopping).
  However, because of the successful IDENTIFY, the QMGR will not
  complete its shutdown until either the CICS region terminates
  or the QMGR is FORCE stopped.
  Keywords: msgDFHMQ0309 MQ0309 0309 CSQ3EXIT
  

Problem conclusion

• DFHMQCON has been amended so that, if an ESTABLISH EXIT call to
  WMQ fails with MQRC=2162 (Queue Manager Stopping), the previous
  IDENTIFY to MQM call is terminated and re-tried.
  

Temporary fix

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

Comments

APAR Information

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

  PI16753

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

  UI22207 UI22208

Modules/Macros

• DFHMQCON
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R800 PSY UI22207

     UP14/10/23 P F410 Ž

• R900 PSY UI22208

     UP14/10/23 P F410 Ž

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.