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 number
IT05978
Reported component name
INTEGRATION BUS
Reported component ID
5724J0530
Reported release
900
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2014-12-08
Closed date
2015-01-28
Last modified date
2016-03-21
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
[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSNQK6","label":"IBM Integration Bus"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
23 March 2020