IBM Support

IT24751: JMS messages delivered to a configured backout queue instead of an MDB can have a missing group id value

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

APAR status

  • Closed as program error.

Error description

  • Messages picked up by a WebSphere Application Server's
    activation specification for delivery to a Message-Driven Bean
    can be missing the original group id of the message if they are
    backed out to a configured backout queue due to some reoccurring
    problem preventing them from being delivered to the MDB's
    onMessage.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users picking up messages from a MQ queue
    manager queue for delivery to an MBD hosted in WAS 8.5 or later,
    where one of the message attributes is a group id set in the
    message's MQMD, and the queue the messages are being picked up
    from has both the backout threshold value (BOTHRESH) and backout
    queue (BOQUEUE) attributes configured.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    If a message picked up by a WebSphere Application Server
    activation specification for delivery to a Message-Driven Bean's
    onMessage method cannot complete delivery to that MDB due to
    some error, or there is some error processing that message in
    the MDB, the message is rolled back to the original queue. If
    this rollback occurs a number of times greater than the backout
    threshold value configured on the original queue, the next time
    the message is picked up it will be sent to the configured
    backout queue.
    
    In this case a message with a non-zero group ID value set in the
    message's MQMD (message descriptor structure) had been rolled
    back a number of times, and so when this was next picked up by
    the activation specification there was an attempt to send this
    message to the configured backout queue. The message sent to the
    backout queue did not have the group ID value that had been set
    on the original message. This was because the code that removed
    the message from the queue to send it to the backout queue used
    the incorrect version of an internal structure when getting the
    message - this structure did not contain a group id property, so
    the value set on the message was lost at this point.
    

Problem conclusion

  • The correct version of the relevant internal structures are now
    used when removing messages from queues for backout, and so
    messages that have been rolled back to a queue a number of
    times, over the specified backout threshold value, are now
    subsequently sent the backout queue with all original properties
    set, including the group id.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.5       7.5.0.10
    v8.0       8.0.0.11
    v9.0 LTS   9.0.0.6
    
    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

    IT24751

  • Reported component name

    WMQ WINDOWS V7

  • Reported component ID

    5724H7220

  • Reported release

    710

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-04-17

  • Closed date

    2018-10-01

  • Last modified date

    2018-10-01

  • APAR is sysrouted FROM one or more of the following:

    IT24741

  • APAR is sysrouted TO one or more of the following:

Fix information

  • Fixed component name

    WMQ WINDOWS V7

  • Fixed component ID

    5724H7220

Applicable component levels



Document information

More support for: WebSphere MQ
APAR / Maintenance

Software version: 710

Reference #: IT24751

Modified date: 01 October 2018


Translate this page: