PI67947: MQ V9 IS NOT HANDLING MQMF_MSG_GROUP FLAG CORRECTLY

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• In MQ V9 the MQMF_MSG_IN_GROUP flag is correctly set on in the
  message put to the queue, but when copying data back into the
  application storage the MsgFlags field is being copied back.
  
  MQMD V9 MQMD.GroupId groupid MQMD.MsgFlags msgflags
  MQMD.MsgSeqNumber msgseqnumber
  .
  Additional symptoms/keywords:
  Group messages are retrieved out of order / sequence
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of IBM MQ for z/OS Version 9 Release 0             *
  * Modification 0.                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * MQMF_MSG_IN_GROUP unexpectedly set in MQMD.MsgFlags when     *
  * putting a message with MQMD.MsgFlags =                       *
  * MQMF_LAST_MSG_IN_GROUP.                                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * None                                                         *
  ****************************************************************
  When MQPUT/MQPUT1 is called to put a message, and passes a
  Version 2 MQMD with MQMD.MsgFlags set to MQMF_LAST_MSG_IN_GROUP,
  the queue manager treats this as if the MQMF_MSG_IN_GROUP were
  also specified.
  When the message is put to the queue, the MQMD associated with
  the message is correctly updated to show that both of these
  flags are set.
  
  The flags in the original MQMD should not be updated, and should
  continue to contain only MQMD_LAST_MSG_IN_GROUP, however an
  error in CSQMPUT causes the updated flags passed with the
  message to incorrectly be copied back in to the caller's MQMD.
  

Problem conclusion

• CSQMPUT is changed to only copy back the output fields relating
  to message grouping when updating the MQMD passed on input to
  MQPUT/MQPUT1.
  

Temporary fix

Comments

APAR Information

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

  PI65896

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

  UI43964

Modules/Macros

• CSQMPUT
  

Fix information

• Fixed component name

  MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R000 PSY UI43964

     UP17/02/08 P F702

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.