PH39070: MQ-IMS BRIDGE IS UNABLE TO PROCESS MESSAGE WITH INCORRECT LLZZ LENGTH

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When a message with the incorrect LLZZ is received, IMS Bridge
  gets suspended waiting for a response and stops processing
  messages. The message isn't moved to DLQ Dead Letter Queue as
  expected.
  

Local fix

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: MQ-IMS bridge is unable to process      *
  *                      messages with incorrect length.         *
  ****************************************************************
  A message being sent over the MQ-IMS bridge specifies a length
  two bytes greater than the length of the first and only message
  segment. The extra two bytes of data contain the value '0002'x ,
  which appear to be the first two LL length bytes of the LLZZ
  header of a subsequent segment. However there are no further
  bytes of data for the required IMS ZZ bytes and application
  data.
  The invalid message is sent to IMS where it is rejected with
  sense NACK_BAD_MSG_LENGTH. The MQ-IMS bridge does not recognise
  the sense from IMS as the outstanding response it is waiting for
  and is left suspended waiting for it to arrive. The invalid
  request is left on the MQ-IMS bridge request queue and further
  messages can not be processed.
  

Problem conclusion

• The MQ-IMS bridge code is updated so that messages specifying a
  segment length less than five will not be sent to IMS. In such
  cases message CSQ2005I will be issued with new feedback code
  '299 (MQFB_DATA_LENGTH_TOO_SHORT)'.
  
  The following page in the IBM MQ 9.1 Knowledge Center is
  updated:
  "IBM MQ-IMS bridge Messages (CSQ2...)"
  https://www.ibm.com/docs/en/ibm-mq/
  9.1?topic=zos-mq-ims-bridge-messages-csq2
  
  The description of message CSQ2005I is updated in the
  'System programmer response' section.
  A new feedback code is added to the list of possible codes
  maintaining the correct numerical sequence.
  The new code appears as follows:
  
  '299 (MQFB_DATA_LENGTH_TOO_SHORT)
                A segment length field was too short in the
                application data of the message.'
  
  An equivalent change is made in the IBM MQ 9.2 Knowledge Center:
  https://www.ibm.com/docs/en/ibm-mq/
  9.2?topic=zos-mq-ims-bridge-messages-csq2
  

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:

  UI79466 UI79467

Modules/Macros

• CMQA     CMQC     CMQP     CMQSTRC  CMQV     CSQ2MTOO CSQA
  CSQC     CSQP     CSQV
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R100 PSY UI79467

     UP22/03/11 P F203

• R200 PSY UI79466

     UP22/03/11 P F203

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.