IV16297: WEBSPHERE MQ EXPLORER BROWSE DIALOG REPORTS A LARGER VALUE FOR THE MESSAGE LENGTH THAN THE SIZE OF MESSAGE DATA DISPLAYED

Fix Pack 7.1.0.2 for WebSphere MQ V7.1
WebSphere MQ V7.5 Fix Pack 7.5.0.1
WebSphere MQ V7.0 Fix Pack 7.0.1.10

APAR status

• Closed as program error.

Error description

• When using a version 7 WebSphere MQ Explorer to browse a message
  on a queue on a WebSphere MQ queue manager, the value of the
  "message length" field is not equivalent to the length of the
  data displayed in the "message data" field.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  The issue affects users of the version 7.0 and 7.1 WebSphere MQ
  Explorer who are browsing messages on a version 7.0 or 7.1
  queue manager.
  
  Platforms affected:
  All Distributed (iSeries, all Unix and Windows) +Java +Java zOS
  ****************************************************************
  PROBLEM SUMMARY:
  When the WebSphere MQ classes for Java browses or consumes a
  message on a WebSphere MQ queue manager, if the message body
  contains WebSphere MQ recognised headers - such as a Rules and
  Formatting version 2 header (RFH2) - these headers are removed
  from the message body and stored in the enumeration of message
  properties within the MQMessage object returned to the Java
  application making the request for the message.
  
  The method:
  
  .      com.ibm.mq.MQMessage.getTotalMessageLength()
  
  reflects the total size of the message body, including the
  headers, as stored in the message on the queue.  This value is
  not modified if header data is removed from the message body
  during the consumption of the message by the WebSphere MQ
  classes for Java.
  
  To determine the length of the message body data after the
  headers have been removed by the WebSphere MQ classes for Java,
  applications can instead call the method:
  
  .      com.ibm.mq.MQMessage.getDataLength()
  
  to return the number of bytes of message data remaining to be
  read.
  
  Alternatively call the method:
  
  .      com.ibm.mq.MQMessage.getMessageLength()
  
  to return the length of the message after headers have been
  removed.
  
  When inspecting the properties of a browsed message on a
  WebSphere MQ queue, the WebSphere MQ Explorer only displayed
  the value returned by:
  
  .      com.ibm.mq.MQMessage.getTotalMessageLength()
  
  alongside the message data itself, which could be difficult to
  comprehend as the total message length reported in the
  WebSphere MQ Explorer may be significantly greater than the
  amount of data displayed in the message's data section.
  

Problem conclusion

• The WebSphere MQ Explorer has been modified so that when the
  properties of a browsed message are displayed, both the total
  message length and the message data length are displayed.
  
  The two different values can be observed in the "Data" panel of
  message properties dialog for the browsed message. After
  applying the code change associated with this APAR, users may
  also need to perform an additional step in order to see the new
  value in the list of browsed messages. This step is to perform
  a clean start of WebSphere MQ Explorer as follows:
  
  Running "strmqcfg -c" (for WebSphere MQ Explorer 7.0)
  
  Or
  
  Running "MQExplorer -c" (for WebSphere MQ Explorer 7.1)
  
  after which both values will be seen when browsing a message.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
                     v7.0
  Platform           Fix Pack 7.0.1.10
  --------           --------------------
  Windows            U200352
  AIX                U853055
  HP-UX (PA-RISC)    U853082
  HP-UX (Itanium)    U853087
  Solaris (SPARC)    U853083
  Solaris (x86-64)   U853089
  iSeries            7.0.1.10
  Linux (x86)        U853084
  Linux (x86-64)     U853088
  Linux (zSeries)    U853085
  Linux (Power)      U853086
  zOS                7.0.1.10
  
                     v7.1
  Platform           Fix Pack 7.1.0.2
  --------           --------------------
  Windows            U200351
  AIX                U853019
  HP-UX (Itanium)    U853052
  Solaris (SPARC)    U853048
  Solaris (x86-64)   U853054
  iSeries            7.1.0.2
  Linux (x86)        U853049
  Linux (x86-64)     U853053
  Linux (zSeries)    U853050
  Linux (Power)      U853051
  zOS                7.1.0.2
  
  Platform           v7.5
  --------           --------------------
  Multiplatforms     7.5.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

• R701 PSY

     UP