IT09607: WEBSPHERE MQ .NET METHOD READSTRING THROWS MQRC_UNEXPECTED_ERROR IF MESSAGE DATA CONTAINS RFH HEADER.

APAR status

• Closed as documentation error.

Error description

• The MQ .NET method ReadString fails with MQRC_UNEXPECTED_ERROR
  if message data contains RFH header.
  
  Exception stack will look like the below
  
   IBM.WMQ.MQException: MQRC_UNEXPECTED_ERROR
     at IBM.WMQ.MQBase.throwNewMQException(Int32 cc, Int32 rc)
     at IBM.WMQ.MQMessage.ReadString(Int32 length)
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users of the MQ .NET client who use the ReadString method to
  read the message data from a message which contains an MQRFH or
  MQRFH2 header.
  
  
  Platforms affected:
  Windows
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  It is the designed behavior that the MQ .NET client returns
  MQRC_UNEXPECTED_ERROR if the ReadString method is used to read a
  message that contains MQRFH or MQRFH2 headers in the data. If
  message data contains RFH header then ReadByte method should be
  used to read the data.
  
  This behavior was not accurately reflected in the product
  documentation.
  

Problem conclusion

• The following note will be added in the below MQ Knowledge
  center pages to clarify this intended behaviour
  
  http://www-01.ibm.com/support/knowledgecenter/SSFKSJ_7.5.0/com.i
  bm.mq.ref.dev.doc/q111220_.htm?lang=en
  
  http://www-01.ibm.com/support/knowledgecenter/SSFKSJ_8.0.0/com.i
  bm.mq.ref.dev.doc/q111220_.htm?lang=en
  
  Note: If the message data contains MQRFH or MQRFH2 header then
  you must use the ReadBytes method to read the data.
  

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:

Fix information

Applicable component levels