PH49378: ORPHANED LOCK IN MQ AFTER MQPUT FAILED WITH MQRC_STORAGE_CLASS_ERROR MQRC 2105 ( 0839 )

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• During MQPUT processing, CSQIMPU2 is called to put the message
  to the queue. Early on in its processing, it obtains intent
  exclusive locks on the queue and its storage class's name. The
  intended design is that these locks are released before
  returning to the caller.
  
  Unfortunately this does not happen for certain error scenarios
  in CSQIMPU2. The put return codes affected by this problem are
  MQRC_STORAGE_CLASS_ERROR  MQRC_Q_FULL and some instances of
  MQRC_PAGESET_ERROR  but there may be more. The locks will later
  be released during EOT for the application task.
  .
  Additional keywords and symptoms:
  --------------------------------
  When an attempt is made to delete a queue with these locks held,
  reason 00D44005 occurs.  For example, if the delete command is
  in CSQUTIL:
  .
  DELETE QL('QUEUE1') QSGDISP(GROUP)
  CSQN205I  COUNT=       3, RETURN=00000000, REASON=00000004
  CSQM122I CSQMUQLC ' DELETE QL' COMPLETED FOR QSGDISP(GROUP)
  CSQN138I 'DELETE QL' command generated for CMDSCOPE(*),
            sent to 2
  CSQN205I  COUNT=       6, RETURN=00000000, REASON=00000004
  CSQN121I 'DELETE QL' command responses from CSQ1
  CSQM101I CSQMUQLC QLOCAL(QUEUE1) IS CURRENTLY IN USE
  CSQM090E CSQMUQLC FAILURE REASON CODE X'00D44005'
  CSQ9023E CSQMUQLC ' DELETE QLOCAL' ABNORMAL COMPLETION
  CSQN205I  COUNT=       3, RETURN=00000000, REASON=00000004
  CSQN121I 'DELETE QL' command responses from CSQ2
  CSQ9022I CSQMUQLC ' DELETE QLOCAL' NORMAL COMPLETION
  CSQN205I  COUNT=       2, RETURN=0000000C, REASON=00000008
  CSQN123E 'DELETE QL' command for CMDSCOPE(*) abnormal completion
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 2 Modification 0 and                 *
  *                 Release 3 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: When running a DELETE QLOCAL(...)       *
  *                      command, it is possible for the         *
  *                      command to fail with an error message   *
  *                      indicating that the queue is still in   *
  *                      use.                                    *
  ****************************************************************
  The code which handles releasing the queue name lock associated
  with PUTs was not releasing the lock correctly if a PUT failed
  with error MQRC_STORAGE_CLASS_ERROR or MQRC_Q_FULL. This then
  prevented the DELETE QLOCAL command from completing
  successfully.
  

Problem conclusion

• The code has been changed to release the queue name lock for
  this error path.
  

Temporary fix

Comments

APAR Information

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

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

  UI91305 UI91306

Modules/Macros

• CSQIMPU2
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R200 PSY UI91306

     UP23/06/15 P F306

• R300 PSY UI91305

     UP23/06/15 P F306

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.