PH16836: MQ CSQ0219E CSQ0225E WHEN MESSAGE BACKUPS ARE BEING DONE THE CITED MESSAGES CAN OCCUR

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Hursley Development finds the root of the problem is a timing
  condition where an SMDS
  offloaded message has been browsed and any properties have been
  copied into the buffer in an RFH2 header. CSQIMGES then detects
  that the message is no longer available (i.e. another task has
  destructively got the message) and retries, locating the next
  
  
  
  message - however a length field is not correctly reset during
  this retry, which causes unexpected message truncation. For
   AMS,
  the message cannot be decrypted without the whole encrypted
  message available, and so MQRC_TRUNCATED_MSG_FAILED is returned
  prior to the PDMQ being copied to the buffer, which causes the
  CSQ0219E/CSQ0225E errors in CSQ0CGET when it attempts to locate
  the PDMQ.
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 1 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: Messages returned by a browse operation *
  *                      on a shared queue contain unexpected    *
  *                      RFH2 headers, and are unexpectedly      *
  *                      truncated.                              *
  *                                                              *
  *                      If the shared queue is protected by     *
  *                      an AMS policy, the MQGET fails with     *
  *                      MQRC2063 (MQRC_SECURITY_ERROR) and      *
  *                      messages CSQ0219E and CSQ0225E are      *
  *                      issued.                                 *
  ****************************************************************
  After locating a message on a shared queue that had been
  offloaded to SMDS, the headers are copied to the message buffer,
  followed by the message data.
  If the message is deleted while this takes place, the message
  cannot be returned, and CSQIMGES attempts to locate the next
  suitable message.
  An error in this retry logic causes the next message to be
  copied to the wrong offset in the message buffer, resulting
  in unexpected headers and message truncation.
  
  In the case of protected queues, the truncation is detected by
  AMS and the browse fails.
  

Problem conclusion

• CSQIMGES is changed to reset the offset into the message buffer
  when retrying after a message being browsed is found to have
  been deleted.
  
  MQSMDS/K
  

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:

  UI66548

Modules/Macros

• CSQIMGES
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R100 PSY UI66548

     UP19/11/27 P F911 ¢

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.