PK74478: MQ QUIESCE HANGS AFTER MIGRATING TO CICS 3.2

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CKQC STOP FORCE request hangs since migrating to CICS 3.2. The
  dump shows that the MQ disconnect task, CKSD, is doing EXEC CICS
  DELAY requests in the SHUT_DISC_RTN proc of DFHMQDSC, waiting
  for all tasks that have done MQ work to complete. However, there
  is still one MQ task still in the system. In CICS 3.1, this MQ
  task would not have prevented the connection from shutting down
  or being forced down.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: The CICS WMQ attach as shipped with     *
  *                      CICS Transaction Server for z/OS V3.2   *
  *                      does not shut down correctly.           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Shut down of the CICS WMQ attach shipped with CICS Transaction
  Server for z/OS V3.2 fails to act in the same way as the
  previous attach shipped via WMQ.
  The two problems which will be corrected in this APAR are:
  . When WMQ has been quiesced twice without a CICS restart the
    second quiesce of WMQ will hang forever. The reason for this
    is that the CKAM transaction uses an open TCB to access WMQ
    via a WMQ thread. CKAM is never terminated and therefore WMQ
    still has the WMQ thread active which prevents the quiesce
    from completing.
  . When the CICS WMQ attach is force closed using the CKQC
    transaction the attach may not close because of a CICS WMQ
    transaction which is in a wait. This transaction will not be
    force purged and so the CICS WMQ attach will hang until the
    CICS transaction comes out of its wait.
  Keywords: FINFIX PK61983
  

Problem conclusion

• DFHMQMON has been changed to ensure the CKAM transaction starts
  a new instance of itself before it terminates.
  DFHMQDSC, DFHMQTRU and DFHMQLOT have been changed to force purge
  any transactions using the CICS WMQ attach and therefore allow
  the attach to complete shutdown.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• ž**** PE09/04/29 FIX IN ERROR. SEE APAR PK83755  FOR DESCRIPTION
  

APAR Information

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

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

  UK42475

Modules/Macros

•    DFHMQDSC DFHMQLOT DFHMQMON DFHMQTRU
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK42475

     UP08/12/18 P F812

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.