IT05978: MQSICREATEBROKER FAILS WITH BIP8986I IF MQSERIES PUBSUB IS DISABLED

APAR status

• Closed as program error.

Error description

• If the mqsicreatebroker command is run to create a broker with a
  queue manager that already exists, and that queue manager has
  the PSMODE property set to 'DISABLED', the command fails with
  the error:
  
  BIP8986I: A failure occurred when the broker tried to update the
  PSMODE for WebSphere MQ queue manager 'QMgrName'. Return code:
  2531. The Publish Subscribe Interface (PSMODE) within WebSphere
  MQ for queue manager 'QMgrName' is currently set to ENABLED.
  This setting is incompatible with IBM Integration Bus in its
  default configuration. The broker tried to change the PSMODE to
  COMPATIBILITY but the request failed.
  Ensure that the WebSphere MQ command server is running and is
  able to process PCF requests.
  
  The error text is incorrect, although the return code of '2531'
  does equate to MQRC_PUBSUB_INHIBITED which is a correct
  reflection of the PSMODE state of 'DISABLED'.
  

Local fix

• Manually change the queue manager's PSMODE setting to 'COMPAT'
  and re-run the mqsicreatebroker command.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of IBM Integration Bus V9.0 creating a broker with a
  queue manager that has the publish subscribe mode disabled.
  
  
  Platforms affected:
  z/OS, MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  If the mqsicreatebroker command is run to create a broker with a
  queue manager that already exists, and that queue manager has
  the PSMODE (Publish/Subscribe mode) property set to 'DISABLED',
  the command fails with the error:
  
  BIP8986I: A failure occurred when the broker tried to update the
  PSMODE for WebSphere MQ queue manager 'QMgrName'. Return
  code:2531. The Publish Subscribe Interface (PSMODE) within
  WebSphere MQ for queue manager 'QMgrName' is currently set to
  ENABLED. This setting is incompatible with IBM Integration Bus
  in its
  default configuration. The broker tried to change the PSMODE to
  COMPATIBILITY but the request failed. Ensure that the WebSphere
  MQ command server is running and is able to process PCF
  requests.
  
  The error text is incorrect for two reasons. Firstly, the PSMODE
  property actually had a value of 'DISABLED', not 'ENABLED' as
  reported. The return code of '2531' does however equate to
  MQRC_PUBSUB_INHIBITED which is a correct reflection of the
  PSMODE state. Secondly, the failure occurs when trying to create
  a WebSphere MQ Topic object. It is not trying to update the
  PSMODE value, but the create attempt fails because publish
  subscribe is disabled.
  
  
  There are a number of resource name changes between WebSphere
  Message Broker and IBM Integration Bus Version 9.0. For details
  visit
  http://pic.dhe.ibm.com/infocenter/wmbhelp/v9r0m0/topic/com.ibm.e
  tools.mft.doc/bb23814_.htm
  

Problem conclusion

• The mqsicreatebroker command now sets PSMODE to COMPAT if it has
  a current value of DISABLED, and it will give a more appropriate
  error message if it fails to create a TOPIC object.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.0       9.0.0.6
  
  The latest available maintenance can be obtained from:
  http://www-01.ibm.com/support/docview.wss?rs=849&uid=swg27006041
  
  If the maintenance level is not yet available,information on
  its planned availability can be found on:
  http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006308
  ---------------------------------------------------------------
  

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

  INTEGRATION BUS

• Fixed component ID

  5724J0530

Applicable component levels

• R900 PSY

     UP