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

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 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