Creating the default system queues on an IBM MQ queue manager

You can create the default system queues on the queue manager that is associated with your integration server, by running a script.

Before you begin

You must have an IBM® MQ server and a queue manager to use with your IBM App Connect Enterprise deployment. For more information about installing IBM MQ components, see the IBM MQ product documentation: https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.1.0/com.ibm.mq.ins.doc/q008320_.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 script command. For more information, see Setting up a command environment.

About this task

Some IBM App Connect Enterprise capabilities require access to IBM MQ components. Some of these capabilities require a set of default system queues to be created on the queue manager that is associated with the integration server. The default system queues are used to store information about in-flight messages. For more information about the capabilities that require the default system queues, see Installing IBM MQ.

Note: By default, running the iib_createqueues command disables IBM 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 iib_createqueues uses to define queues.

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

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

Procedure

From the command environment (on Linux) or the IBM App Connect Enterprise 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
The qmgr_name parameter specifies the name of the IBM MQ queue manager where you want to create the queues.

The iib_group parameter specifies the primary group of the system account that runs the integration server.

Results

The default IBM App Connect Enterprise 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.FAILED)     TYPE(QLOCAL)
   QUEUE(SYSTEM.BROKER.ADAPTER.INPROGRESS) TYPE(QLOCAL)                         
   QUEUE(SYSTEM.BROKER.ADAPTER.NEW)        TYPE(QLOCAL)
   QUEUE(SYSTEM.BROKER.ADAPTER.PROCESSED)  TYPE(QLOCAL)                         
   QUEUE(SYSTEM.BROKER.ADAPTER.UNKNOWN)    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.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 server 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 https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.1.0/com.ibm.mq.ref.adm.doc/q083460_.htm.