IBM Support

IT21093: Administered subscription with DESTCLAS(PROVIDED) cannot be joined by MQ Light clients.

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

  • There are cases where it is useful for an administrator to
    create an MQ Light subscription manually (following the MQ Light
    sub naming conventions of ':private:<clientid>:<topicstring>' or
    ':share:<sharename>:<topicstring>').
    
    This works currently if the DESTCLAS of the administered
    subscription is MANAGED, because MQ Light clients use managed
    subscriptions themselves. However if the administered sub is
    DESTCLAS(PROVIDED), the MQ Light client tries to modify it to
    DESTCLAS(MANAGED) which fails. Error that may be encountered is
    MQRC_DEST_CLASS_NOT_ALTERABLE
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of:
    
    - The WebSphere MQ V8 AMQP channel
    - The IBM MQ V9 AMQP channel
    
    who have a MQ Light client applications that:
    
    - subscribes to an administered Subscription with PROVIDED
    destination (queue).
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    Administered subscription of a MQ Light client failed when it
    was DESTCLASS(PROVIDED) with the following exception:
    
    &#09;MQException: AMQXR0004E: MQSeries verb=SPISubscribe(String)
    returned cc=2(int) MQCC_FAILED rc=2533(int)
    MQRC_DEST_CLASS_NOT_ALTERABLE
    
    because the MQ Light client tried to modify the administered
    subscription to DESTCLAS(MANAGED). This caused a problem because
    MQ Light clients can use only managed subscriptions.
    

Problem conclusion

  • The AMQP listener has been updated to let the MQ Light clients
    join an existing administered subscription without modifying the
    DESTCLAS.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v8.0       8.0.0.8
    v9.0 LTS   9.0.0.3
    
    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

    IT21093

  • Reported component name

    WMQ BASE MULTIP

  • Reported component ID

    5724H7251

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-06-20

  • Closed date

    2017-07-25

  • Last modified date

    2017-07-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 BASE MULTIP

  • Fixed component ID

    5724H7251

Applicable component levels

  • R800 PSY

       UP

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

Document Information

Modified date:
25 July 2017