PH30886: CSQX036E AND CSQT855E AFTER MOVING SYSTEM.RETAINED.PUB.QUEUE FROM ONE PSID TO ANOTHER

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CSQX036E and CSQT855E after moving SYSTEM.RETAINED.PUB.QUEUE
  from one PSID to another.
  

Local fix

• na
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 1 Modification 0 and Release 2       *
  *                 Modification 0.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: When moving messages between queues     *
  *                      with the MQSC command MOVE QLOCAL,      *
  *                      depending on the source queue PROPCTL   *
  *                      value, accompanying message properties  *
  *                      may be lost.                            *
  *                                                              *
  *                      If the target queue was the             *
  *                      SYSTEM.RETAINED.PUB.QUEUE, then         *
  *                      restarting the QMGR will result in a    *
  *                      5C6-00D40094 abend, and the Pub/Sub     *
  *                      daemon failing to start.                *
  ****************************************************************
  When performing a MOVE QLOCAL command, the QMGR gets the
  messages from the source queue and puts them on the target
  queue. When it gets a message from the source queue, it uses the
  queue's PROPCTL value to decide how to process any accompanying
  message properties. Depending on the value set in the PROPCTL
  field, this can result in message properties not being moved
  with the message.
  

Problem conclusion

• The MOVE QLOCAL processing was changed to always move message
  properties to/from certain SYSTEM queues such as the
  SYSTEM.RETAINED.PUB.QUEUE.
  
  During startup, if the QMGR finds a message with no properties
  on the SYSTEM.RETAINED.PUB.QUEUE, it will output message
  CSQM068I and continue rebuilding the retained publications.
  
  The IBM MQ for z/OS Version 9.1.x and Version 9.2.x
  Documentation are updated:
  IBM MQ
   Reference
    Messages
     IBM MQ for z/OS messages, completion, and reason codes
      Messages for IBM MQ for z/OS
       Message manager messages (CSQM...)
  ( https://www.ibm.com/docs/en/ibm-mq/
                     9.1?topic=zos-message-manager-messages-csqm )
  ( https://www.ibm.com/docs/en/ibm-mq/
                     9.2?topic=zos-message-manager-messages-csqm )
  
  Added message CSQM068I:
  "
  CSQM068I
      csect-name Failed to rebuild n retained publications
  
  Severity
      4
  
  Explanation
      While rebuilding the retained publications, n messages were
      found on the SYSTEM.RETAINED.PUB.QUEUE without any message
      properties.
  
  System action
      The associated retained publications were not rebuilt.
  
  System programmer response
      If messages were recently moved to the
      SYSTEM.RETAINED.PUB.QUEUE, then ensure that the PROPCTL
      value of the source queue will not result in any message
      properties being lost.
  
      If no messages were recently moved to the
      SYSTEM.RETAINED.PUB.QUEUE, then note this message and
      contact your IBM support center.
  "
  
  IBM MQ
   Reference
    Administration reference
     MQSC commands
      MOVE QLOCAL on z/OS
  ( https://www.ibm.com/docs/en/ibm-mq/
                              9.1?topic=commands-move-qlocal-zos )
  ( https://www.ibm.com/docs/en/ibm-mq/
                              9.2?topic=commands-move-qlocal-zos )
  
  Added bullet point to 'Usage notes for MOVE QLOCAL':
  "
  11. Treatment of message properties depends on the source queue
  PROPCTL value. Message properties are handled as if an MQGET was
  performed with MQGMO_PROPERTIES_AS_Q_DEF.
  "
  
  Added corresponding information note:
  "
  Note: Message properties will always be moved when MOVE QLOCAL
  is used to/from certain SYSTEM queues which hold messages with
  properties required by MQ.
  "
  

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:

  UI75222 UI75223 UI75224 UI75225 UI75226 UI75227 UI75228 UI75229
  UI75230 UI75231 UI75232 UI75233

Modules/Macros

• CSQFMDIC CSQFMDIE CSQFMDIF CSQFMDIK CSQFMDIU CSQFMTXC CSQFMTXE
  CSQFMTXF CSQFMTXK CSQFMTXU CSQMMOVE CSQMTORP
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R100 PSY UI75228

     UP21/05/29 P F106

• R101 PSY UI75229

     UP21/06/02 P F106

• R102 PSY UI75230

     UP21/06/02 P F106

• R103 PSY UI75231

     UP21/06/02 P F106

• R104 PSY UI75232

     UP21/06/02 P F106

• R105 PSY UI75233

     UP21/06/02 P F106

• R200 PSY UI75222

     UP21/05/29 P F106

• R201 PSY UI75223

     UP21/05/29 P F106

• R202 PSY UI75224

     UP21/05/29 P F106

• R203 PSY UI75225

     UP21/05/29 P F106

• R204 PSY UI75226

     UP21/05/29 P F106

• R205 PSY UI75227

     UP21/05/29 P F106

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.