IBM Support

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

Subscribe

You can track all active APARs for this component.

 

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 number

    IV16297

  • Reported component name

    WMQ AIX V7

  • Reported component ID

    5724H7221

  • Reported release

    701

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-02-29

  • Closed date

    2012-06-26

  • Last modified date

    2013-03-25

  • 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

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCPQ63","label":"APAR \/ Maintenance"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
25 March 2013