IT02389: AMQSBCG RETREIVES INCORRECT MESSAGE ON THE DESTINATION QUEUE WHEN API EXIT REMOVED MESSAGE PROPERTIES

Fix Pack 8.0.0.1 for WebSphere MQ V8.0

APAR status

• Closed as program error.

Error description

• When message is sent to a remote queue manager using "amqsput",
  where both the local and remote queue managers have an API exit
  removes all message properties, then only a truncated message is
  browsed by "amqsbcg" as the MQRFH2 was not removed.
  
  From the trace, it is seen that the length of the original
  message is correct, however the message contained first 'n'
  character of RFH structure which is not expected.
  For example, when a message containing a text message string,
  "testMessage1" is put to remote queue definition, and the local
  queue browsed at the remote end with "amqsbcg" program displays
  an output as follows:
  
  length - 12 of 12 bytes
  00000000: 5246 4820 0200 0000 6400 0000 'RFH...d...
  
  The message is truncated and in place of the text message
  "testMessage1", we see the RFH header data present.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users using an API exit which removes message properties.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  When the queue manager prepared to deliver a message to a
  consuming application, it should remove an MQRFH2 header if one
  exists and there are no message properties. This did not happen,
  and so the message delivered to the consumer contained
  unexpected data.
  

Problem conclusion

• Modified the code such that the MQRFH2 is stripped if no
  properties are left after the message is through receiver API
  exit
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.1       7.1.0.7
  v7.5       7.5.0.5
  v8.0       8.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 BASE MULTIP

• Fixed component ID

  5724H7241

Applicable component levels

• R750 PSY

     UP