IV83734: MQ client reports MQRC_NOT_CONVERTED (2119) when trying to MQGETa message

APAR status

• Closed as program error.

Error description

• An MQ client reports reason code  2119 (MQRC_NOT_CONVERTED)
  when trying to MQGET a message.
  
  There is no error logged in the queue manager log and no FDC
  created.
  
  The issue can be observed within an
  MQ trace captured on the queue manager where the queue
  containing the message
  exists.  In the amqrmppa process trace file the follwing entry
  will be observed:-
  
  rriConvertMsgHdrs rc=MQRC_HEADER_ERROR
  

Local fix

• Modifying SHARECNV to zero for the channel works around the
  issue.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users of IBM MQ with large headers as part of the message
  payload may be affected by this issue.  For example, a large
  RFH2 message may trigger the issue.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  The problem was caused by an MQRC_HEADER_ERROR in the server.
  When parsing the message headers the queue manager encountered
  an RFH header which has
  a structure length which was larger than the amount of data that
  can be returned to the client in one
  transmission.  A sanity check on these lengths fails and causes
  MQRC_HEADER_ERROR
  to be returned and this is passed back to the client.
  
  If no conversion was expected then it was possible for the
  message data to
  reach the application as expected and so the only symptom of the
  problem is
  the bad return code.
  

Problem conclusion

• The MQ queue manager code has been corrected to successfully
  handle the larger structure length, provided that the header to
  be converted is present in the current transmission segment.
  
  The queue manager will not attempt to convert headers that span
  multiple transmission segments.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.0       7.0.1.15
  v7.1       7.1.0.8
  v7.5       7.5.0.8
  v8.0       8.0.0.6
  v9.0 CD    9.0.1
  v9.0 LTS   9.0.0.1
  
  The latest available maintenance can be obtained from
  'WebSphere MQ Recommended Fixes'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
  
  If the maintenance level is not yet available information on
  its planned availability can be found in 'WebSphere MQ
  Planned Maintenance Release Dates'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
  ---------------------------------------------------------------
  

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

• Fixed component name

  WMQ AIX V7

• Fixed component ID

  5724H7221

Applicable component levels