IBM Support

IT24396: MQ reconnectable client fails to reconnect to queue manager after failover

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

  • Some of MQ reconnectable client applications like MQ
    sample application amqscbfc fail to reconnect to the
    MQ queue manager after the MQ queue manager fails over.
    
    The application reports "2162 MQRC_Q_MGR_STOPPING" error.
    The failover could be a multi-instance queue manager
    failover or the queue manager failover using high
    availability software like "Veritas Cluster for MQ HA".
    
    Note: Some sample applications like amqsphac are able to
          reconnect after 2009 errors
    

Local fix

  • Restart the client application
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Reconnectable client connections running at the time the MQ
    administrator runs the "endmqm -i -r <QM>" command.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    Due to a programming error introduced in MQ version 8.0.0.0,
    reconnectable client connections may be broken with a
    MQRC_Q_MGR_STOPPING error when multi-instance queue managers
    fail over to a backup queue manager.
    

Problem conclusion

  • The programming error has been resolved, so that on
    multi-instance queue manager fail over, reconnectable client
    connections are restored when the queue manager starts up.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v8.0       8.0.0.10
    v9.0 LTS   9.0.0.5
    
    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

    IT24396

  • Reported component name

    IBM MQ BASE M/P

  • Reported component ID

    5724H7261

  • Reported release

    900

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-03-16

  • Closed date

    2018-04-19

  • Last modified date

    2018-04-19

  • 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

    IBM MQ BASE M/P

  • Fixed component ID

    5724H7261

Applicable component levels

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.0","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
19 April 2018