Create a default queue manager
The default queue manager is the queue manager that applications connect to if they do not specify a queue manager name in an MQCONN call. It is also the queue manager that processes MQSC commands when you invoke the runmqsc command without specifying a queue manager name. To create a queue manager, we use the IBM MQ control command crtmqm.
Before starting
Before creating a default queue manager, read through the considerations described in Create queue managers on Multiplatforms.
When we use crtmqm to create a queue manager on UNIX, if the /var/mqm/qmgrs/qmgr directory already exists, is owned by mqm, and is empty, it is used for the queue manager data. If the directory is not owned by mqm, the creation of the queue manager fails with a First Failure Support Technology (FFST) message. If the directory is not empty, a new directory is created for the queue manager data.
This consideration applies even when the /var/mqm/qmgrs/qmgr directory already exists on a separate local file system.
When creating a queue manager by using the crtmqm command, the command automatically creates the required default objects and system objects. Default objects form the basis of any object definitions that you make and system objects are required for queue manager operation.
By including the relevant parameters in the command, we can also define, for example, the name of the default transmission queue to be used by the queue manager, and the name of the dead letter queue.
On Windows, we can use the sax option of the crtmqm command to start multiple instances of the queue manager.
For more information about the crtmqm command and its syntax, see crtmqm.
Procedure
To create a default queue manager, use the crtmqm command with the -q flag. The following example of the crtmqm command creates a default queue manager called SATURN.QUEUE.MANAGER:crtmqm -q -d MY.DEFAULT.XMIT.QUEUE -u SYSTEM.DEAD.LETTER.QUEUE SATURN.QUEUE.MANAGERwhere:
- -q
- Indicates that this queue manager is the default queue manager.
- -d MY.DEFAULT.XMIT.QUEUE
- Is the name of the default transmission queue to be used by this queue manager. Note: IBM MQ does not create a default transmission queue for you; you have to define it yourself.
- -u SYSTEM.DEAD.LETTER.QUEUE
- Is the name of the default dead-letter queue created by IBM MQ on installation.
- SATURN.QUEUE.MANAGER
- Is the name of this queue manager. This must be the last parameter specified on the crtmqm command.
What to do next
When you have created a queue manager and its objects, use the strmqm command to Start the queue manager.
Parent topic: Create queue managers on Multiplatforms
Related tasks
Related information