IBM Support

IT21111: MQRC_SUB_INHIBITED results in AMQ8101: WebSphere MQ error (9C7) has occurred.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When runmqsc encounters an MQRC_SUB_INHIBITED error, a hex
    return code is returned instead of a useful error message:
    
    DEFINE SUB(X) DEST(X) TOPICSTR(X)
    
    Resulting error is:
    AMQ8101: WebSphere MQ error (9C7) has occurred.
    

Local fix

  • If the administrative node has no parent administrative topic
    object then it will inherit its attributes from
    SYSTEM.BASE.TOPIC.
    
    To work around this issue then either set the SUB attribute of
    SYSTEM.BASE.TOPIC to ENABLED, or define a parent administrative
    topic object for the node with a SUB attribute set to ENABLED.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users of the DEFINE SUB command may observe this issue
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    If no administrative topic exists between the root topic
    SYSTEM.BASE.TOPIC and a topic node lower in the hierarchy, then
    the topic node will inherit the attributes of the
    SYSTEM.BASE.TOPIC.
    
    If the SUB attribute of SYSTEM.BASE.TOPIC is set to DISABLED
    then the DEFINE SUB runmqsc command will fail with error code
    MQRC_SUB_INHIBITED if the TOPICSTR attribute points to a node
    whose administrative node resolves to topic SYSTEM.BASE.TOPIC.
    
    There is no error message defined to describe MQRC_SUB_INHIBITED
    and instead the following is displayed:
    
    AMQ8101: WebSphere MQ error (9C7) has occurred.
    

Problem conclusion

  • The runmqsc code has been updated so that a new error message is
    displayed if a runmqsc command fails with MQRC_SUB_INHIBITED.
    The following error is now displayed in runmqsc:
    
    AMQ8928: Subscription creation inhibited.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.5       7.5.0.9
    v8.0       8.0.0.8
    v9.0 CD    9.0.4
    v9.0 LTS   9.0.0.2
    
    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

    IT21111

  • Reported component name

    WMQ BASE MULTIP

  • Reported component ID

    5724H7241

  • Reported release

    750

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-06-21

  • Closed date

    2017-09-05

  • Last modified date

    2017-12-13

  • 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

    5724H7241

Applicable component levels

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

Document Information

Modified date:
13 December 2017