Creating the default IBM Integration Bus queues on a WebSphere MQ queue manager

You can create the default IBM® Integration Bus queues on the queue manager that is associated with your integration node by running a script.

Before you begin

You must have a WebSphere® MQ server and a queue manager to use with your IBM Integration Bus deployment. For information about installing WebSphere MQ components, see the WebSphere MQ product documentation: http://www.ibm.com/support/knowledgecenter/SSFKSJ_8.0.0/com.ibm.mq.ins.doc/q008250_.htm.
You must be a member of the mqm and mqbrkrs operating system groups.
Ensure that the command environment is initialized, by running the mqsiprofile command.

About this task

WebSphere MQ is no longer a prerequisite for using IBM Integration Bus on distributed systems. However, some IBM Integration Bus capabilities require access to WebSphere MQ components, and a subset of these capabilities require a set of default system queues to be created on the queue manager that is associated with the integration node. The default system queues are used to store information about in-flight messages. For details of the capabilities that require the default system queues, see Installing WebSphere MQ.

Note: By default, running the iib_createqueues command disables WebSphere MQ channel authentication for the specified queue manager. If you want to enable channel authentication, you can modify the sample MQSC script, iib_queues_create.mqsc, that the command uses to define IIB queues.

You cannot use a secured queue manager as the local default queue manager for an integration node.

Complete the following steps to create the default system queues on Windows and Linux®.

Procedure

From the command environment (on Linux) or the IBM Integration Console (on Windows), navigate to the following directory:
- install_dir\server\sample\wmq
- install_dir/server/sample/wmq
Run the following command:
- iib_createqueues.cmd qmgr_name
- ./iib_createqueues.sh qmgr_name iib_group
where:
- qmgr_name queue manager that you intend to use with the integration node.
- iib_group is the primary group of the system account that runs the integration node.

Results

The default IBM Integration Bus queues are created on the queue manager.

To check that the queues were created, type the following commands:

runmqsc qmgr_name
display queue(SYSTEM.BROKER*)

A message is returned that lists the queues that were created:

1 : display queue(SYSTEM.BROKER*)
AMQ8409: Display Queue details. 
 QUEUE(SYSTEM.BROKER.ADAPTER.PROCESSED) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.ADMIN.STREAM) TYPE(QLOCAL)
 QUEUE(SYSTEM.BROKER.AGGR.CONTROL) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.AGGR.REPLY) TYPE(QLOCAL)
 QUEUE(SYSTEM.BROKER.AGGR.REQUEST) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.AGGR.TIMEOUT) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.AGGR.UNKNOWN) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.AUTH) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.CD.MODEL) TYPE(QMODEL) 
 QUEUE(SYSTEM.BROKER.CONTROL.QUEUE) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.DC.AUTH) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.DC.BACKOUT) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.DC.RECORD) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.DEFAULT.STREAM) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.EDA.COLLECTIONS) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.EDA.EVENTS) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.FTE.MODEL) TYPE(QMODEL) 
 QUEUE(SYSTEM.BROKER.INTER.BROKER.COMMUNICATIONS) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.MODEL.QUEUE) TYPE(QMODEL) 
 QUEUE(SYSTEM.BROKER.SEQ.EXPIRY) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.SEQ.GROUP) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.SEQ.NUMBER) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.TIMEOUT.QUEUE) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.WEBADMIN.SUBSCRIPTION) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.WS.ACK) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.WS.INPUT) TYPE(QLOCAL) 
 QUEUE(SYSTEM.BROKER.WS.REPLY) TYPE(QLOCAL)

Note: You can delete the queues that are created for an integration node on a specified queue manager, by running the following MQSC command from the same directory:

runmqsc qmgr_name < iib_queues_delete.mqsc

For more information about the runmqsc command, see http://www.ibm.com/support/knowledgecenter/SSFKSJ_8.0.0/com.ibm.mq.adm.doc/q020620_.htm.