crtmqm (create queue manager)
Create a queue manager.
Purpose
You can use the crtmqm command to create a queue manager.
Syntax
Parameters
- QMgrName
- Specifies the name of the queue manager that you want to create.
- -c Text
- Specifies descriptive text for this queue manager.
- -d DefaultTransmissionQueue
- Specifies the name of the local transmission queue where remote messages are put if a transmission queue is not explicitly defined for their destination.
- -fe
- Specifies that the file system for the queue manager is encrypted. You can optionally specify the encryption passphrase by using the -fp parameter, otherwise you are prompted for the passphrase when you run the command.
- -fp Passphrase
- Used in conjunction with the -fe parameter, optionally specifies the encryption passphrase. If you specify -fe but omit -fp you are prompted for the passphrase when you run the command. The passphrase can be between 1 and 512 characters. You should store a copy of the passphrase somewhere safe.
- -fs FileSystemSize
- Specifies that the queue manager is created with the file system size FileSystemSize. If you do not specify this argument, the file system size defaults to 64 GB.
- -h MaximumHandleLimit
- Specifies the maximum number of handles that an application can open at the same time.
- -ic FilePath
- Automatic configuration of MQSC attributes.
Specify a location containing MQSC commands to be automatically applied to the queue manager on every queue manager restart. You can specify a filename, or a directory where each file with the
.mqsc
suffix is automatically processed. The file path must be under mqbackup:///. For information about this feature, see Automatic configuration from an MQSC script at startup in the IBM MQ documentation. - -ii FilePath
- Automatic configuration of INI attributes.
Specify a location containing INI format information to be automatically applied as an override to the qm.ini file on every queue manager restart. You can specify a filename, or a directory where each file with the
.ini
suffix is automatically processed. The filepath must be under mqbackup:///. For information about this feature, see Automatic configuration of qm.ini at startup in the IBM MQ documentation. - -iv VARIABLE=VALUE[;VARIABLE=VALUE]
- Configuration variable for use with automatic uniform clusters.
Specify a name and associated value for use as an insert when processing MQSC definitions. Currently only used for CONNAME fields in defining cluster receivers for automatic uniform clusters.
- -lf LogFilePages
- Specifies the number of log file pages to use for the log files.
- -lp LogPrimaryFiles
- Specifies the log files that are allocated when the queue manager is created.
- -ls LogSecondaryFiles
- Specifies the log files that are allocated when the primary files are exhausted.
- -p PortNumber
- Create a managed TCP listener on the specified port.
- -sa
- Automatic queue manager startup. The queue manager is configured to start automatically when the
appliance restarts. This argument is mutually exclusive with
-sx
. - -sx
- Specifies that the queue manager is a high availability (HA) queue manager.
- -t IntervalValue
- Specifies the trigger time interval in milliseconds for all queues that are controlled by this queue manager.
- -u DeadLetterQueue
- Specifies the name of the local queue that is to be used as the dead-letter (undelivered-message) queue.
- -x MaximumUncommittedMessages
- Specifies the maximum number of uncommitted messages under any one sync point.
- -fc SANvolume
- Specifies that the queue manager uses SAN storage. The LUN that the queue manager is associated with is identified by a previously-created volume object specified by SANvolume. This option is mutually exclusive with the -sx option, because SAN storage is not available to high availability queue managers. (SAN storage is available only on M2001 and M2000 appliances, it is not available on M2002 appliances.)
Usage notes
- This command must be run from the IBM MQ administration mode. If the system is in the IBM MQ administration mode the prompt includes
mqa(mqcli)#
. To enter the IBM MQ administration mode, entermqcli
on the command line. To exit the IBM MQ administration mode, enterexit
on the command line. - After you create the queue manager, you can use the strmqm command to start the queue manager. A high availability queue manager is started automatically after creation, so you do not need to start it by using strmqm.
- When a queue manager is created, the default and system objects are also created. These objects are listed in System and default objects in the IBM MQ documentation.
- If you create a high availability queue manager with an encrypted file system, the passphrase is automatically shared with the second appliance in the HA group.
- For more information about this command in IBM MQ, see ctrmqm in the IBM MQ documentation.
Examples
- The following command creates a queue manager that is called
QM1
, with a description ofexample queue manager
, and creates the system and default objects:crtmqm -c "example queue manager" QM1
- The following command creates a queue manager that is called
QM2
. It creates the system and default objects, sets the trigger interval to 5000 milliseconds (5 seconds), and specifiesSYSTEM.DEAD.LETTER.QUEUE
as its dead-letter queue.crtmqm -t 5000 -u SYSTEM.DEAD.LETTER.QUEUE QM2
- The following command creates a queue manager that is called
QM3
. The file system is encrypted using the passphraseApples-grow-on-trees
. The queue manager is created with a 512 MB file system:crtmqm -fs 512M -fe -fp Apples-grow-on-trees QM3