IBM Support

IT24165: When an AMQP client unsubscribes to pre-existing queue object an FDC with Probe ID XR18012013 is generated

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

  • An AMQP client connects to a queue manager and subscribes to an
    existing administratively created subscription with a provided
    destination and then tries to unsubscribe from that
    subscription. When the unsubscribe is called a FDC is thrown
    like:
    
    | Source Class      :-
    com.ibm.mq.MQXRService.MQManagedSubscriptionListener
                |
    | Source Method     :- close
    
         |
    | Probe Id          :- XR18012013
    
    |
    
    com.ibm.mq.MQXRService.MQException: MQRC 2533
    MQRC_DEST_CLASS_NOT_ALTERABLE
    	at
    com.ibm.mq.MQXRService.MQConnection.getMQException(MQConnection.
    java:1252)
    	at
    com.ibm.mq.MQXRService.MQConnection.spiSubscribe(MQConnection.ja
    va:758)
    	at
    com.ibm.mq.MQXRService.MQSubscriptionWrapper.doSubscribeSpi(MQSu
    bscriptionWrapper.java:587)
    	at
    com.ibm.mq.MQXRService.MQSubscriptionWrapper.subWithOptions(MQSu
    bscriptionWrapper.java:542)
    	at
    com.ibm.mq.MQXRService.MQSubscriptionWrapper.alterSub(MQSubscrip
    tionWrapper.java:336)
    	at
    com.ibm.mq.MQXRService.MQManagedSubscriptionListener.close(MQMan
    agedSubscriptionListener.java:390)
    	at
    com.ibm.mq.MQXRService.AMQPServerSessionV10.processProtonUpdates
    (AMQPServerSessionV10.java:1288)
    	at
    com.ibm.mq.MQXRService.AMQPServerSessionV10.handleReceive(AMQPSe
    rverSessionV10.java:438)
    	at
    com.ibm.mq.MQXRService.AMQPServerWireContext.receive(AMQPServerW
    ireContext.java:176)
    	at
    com.ibm.mq.communications.NonBlockingConnection.receive(NonBlock
    ingConnection.java:378)
    

Local fix

  • If the client simply disconnects without first calling
    unsubscribe, the client's subscription seems to be cleared up
    and no FDC is written.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users who have AMQP clients that subscribe to
    previously-existing administratively-created subscriptions with
    provided destinations, and then try to unsubscribe from those
    subscriptions.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    An AMQP client that subscribed to a pre-existing
    administratively-created subscription with a provided
    destination, then tried to unsubscribe from that subscription
    caused an FDC to be thrown from the queue manager's AMQP
    service, with probe ID XR18012013, and reporting a return code
    MQRC_DEST_CLASS_NOT_ALTERABLE. This also caused the AMQP client
    to be forcibly disconnected from the server.
    
    This issue could only be seen at fixpack levels that included
    APAR IT21093 - so  8.0.0.8, 9.0.0.3, 9.0.1.0 or later. Before
    that APAR, it was not possible for AMQP clients to subscribe to
    pre-existing administratively created subscriptions.
    

Problem conclusion

  • An AMQP client that has subscribed to a pre-existing
    administratively-created subscription with a provided
    destination can now unsubscribe from this without any errors.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v8.0       8.0.0.11
    v9.0 LTS   9.0.0.6
    v9.1 CD    9.1.1
    v9.1 LTS   9.1.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

    IT24165

  • Reported component name

    IBM MQ BASE M/P

  • Reported component ID

    5724H7261

  • Reported release

    903

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-02-22

  • Closed date

    2018-07-17

  • Last modified date

    2018-08-29

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

    IT23986

  • 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":"903","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
29 August 2018