CRTMQM (Create Message Queue Manager)

Where allowed to run: All environments (*ALL)
Threadsafe: Yes

The Create Message Queue Manager (CRTMQM) command creates a local queue manager that can be started with the Start Message Queue Manager (STRMQM) command.

Parameters

Table 1. Command parameters
Keyword	Description	Choices	Notes
MQMNAME	Message Queue Manager name	Character value	Required, Positional 1
TEXT	Text 'description'	`Character value`, *BLANK	Optional, Positional 2
TRGITV	Trigger interval	0-999999999, 999999999	Optional, Positional 3
UDLMSGQ	Undelivered message queue	`Character value`, *NONE	Optional, Positional 4
DFTTMQ	Default transmission queue	`Character value`, *NONE	Optional, Positional 5
MAXHDL	Maximum handle limit	0-999999999, 256	Optional, Positional 6
MAXUMSG	Maximum uncommitted messages	1-999999999, 10000	Optional, Positional 7
DFTQMGR	Default Queue Manager	YES, NO	Optional, Positional 8
MQMLIB	Queue Manager Library	`Name`, *AUTO	Optional, Positional 9
MQMDIRP	Data Directory Prefix	`Character value`, *DFT	Optional, Positional 10
ASP	ASP Number	1-32, SYSTEM, ASPDEV	Optional, Positional 11
ASPDEV	ASP device	`Character value`, *ASP	Optional, Positional 12
THRESHOLD	Journal receiver threshold	100000-1000000000, DFT, MIN, *MAX	Optional, Positional 13
JRNBUFSIZ	Journal buffer size	32000-15761440, *DFT	Optional, Positional 14

Message Queue Manager name (MQMNAME)

Specifies the name of the message queue manager.

queue-manager-name: Specify the name of the queue manager. The name can contain up to 48 characters. The maximum number of characters is reduced if the system is using a double byte character set (DBCS).

Text 'description' (TEXT)

Specifies text that briefly describes the queue manager definition.

The possible values are:

*BLANK: No text is specified.
description: Specify no more than 64 characters enclosed in apostrophes.
Note: The field length is 64 bytes and the maximum number of characters is reduced if the system is using a double byte character set (DBCS).

Trigger interval (TRGITV)

Specifies the trigger time interval, expressed in milliseconds, for use with queues that have TRGTYPE(*FIRST) specified.

When the arrival of a message on a queue causes a trigger message to be put on the initiation queue, then any message that arrives on the same queue within the specified interval does not cause another trigger message to be put on the initiation queue.

The possible values are:

999999999: The trigger time interval is 999999999 milliseconds.
interval-value: Specify a value in milliseconds, in the range 0 through 999999999.

Undelivered message queue (UDLMSGQ)

Specifies the name of the local queue that is to be used for undelivered messages. Messages are put on this queue if they cannot be routed to their correct destination.

The possible values are:

*NONE: There is no undelivered-message queue. The attribute is set to a blank string.
undelivered-message-queue-name: Specify the name of a local queue that is to be used as the undelivered-message queue.

Default transmission queue (DFTTMQ)

Specifies the name of the local transmission queue that is to be used as the default transmission queue. Messages transmitted to a remote queue manager are put on the default transmission queue if there is no transmission queue defined for their destination.

The possible values are:

*NONE: There is no default transmission queue. The attribute is set to a blank string.
default-transmission-queue-name: Specify the name of a local transmission queue that is to be used as the default transmission queue.

Maximum handle limit (MAXHDL)

Specifies the maximum number of handles that any one job can have open at the same time.

The possible values are:

256: The default number of open handles is 256.
maximum-handle-limit: Specify a value in the range 0 through 999999999.

Maximum uncommitted messages (MAXUMSG)

Specifies the maximum number of uncommitted messages. That is:

The number of messages that can be retrieved, plus
The number of messages that can be put on a queue, plus
Any trigger messages generated within this unit of work,

under any one syncpoint. This limit does not apply to messages that are retrieved or put outside syncpoint.

The possible values are:

10000: The default value is 10000 uncommitted messages.
maximum-uncommitted-messages: Specify a value in the range 1 through 999999999.

Default Queue Manager (DFTQMGR)

Specifies whether the queue manager being created is the default queue manager.

The possible values are:

*NO: The queue manager is not to be the default queue manager.
*YES: The queue manager is to be the default queue manager.

Queue Manager Library (MQMLIB)

Specifies the library to be used by the queue manager.

The possible values are:

*AUTO: The library to be used by the queue manager is chosen automatically.
library name: Specify the library to be used by the queue manager.

Data Directory Prefix (MQMDIRP)

Specifies the data directory prefix to be used by the queue manager. The queue manager creates a directory here to store its data files, principally message data residing on queues.

The possible values are:

*DFT

The default data directory prefix is '/QIBM/UserData/mqm'.

directory-prefix

Specify the data directory prefix to be used by the queue manager. This directory prefix may be located in a filesystem either in a local disk pool or in a networked filesystem e.g. NFS.

The queue manager directory can be placed into an independent auxiliary storage pool by setting the data directory prefix accordingly. For example specifying MQMDIRP('/MYASPDEV/QIBM/UserData/mqm/qmgrs') would store queue manager data in the MYASPDEV device.

The queue manager library, journals and journal receivers can be placed into an independent auxiliary storage pool by setting the ASP and ASPDEV parameters.

Independent auxiliary storage pools can be switched between systems to increase the availability of a queue manager. Refer to the IBM® MQ documentation on configuring a queue manager for high availability.

ASP Number (ASP)

Specifies the auxiliary storage pool from which the system allocates storage for the queue manager library, journal and journal receivers.

Note that the auxiliary storage pool identified in this parameter will not be used for the queue manager data files which are located in the integrated file system (IFS). To allocate queue manager data files in a specific auxiliary storage pool refer to the MQMDIRP parameter.

The possible values are:

*SYSTEM: The system auxiliary storage pool (ASP 1) provides the storage for the queue manager library, journal and journal receivers.
*ASPDEV: Storage for the queue manager library, journal and journal receivers is allocated from the primary or secondary ASP specified for the ASPDEV parameter.
auxiliary-storage-pool-number: Specify a value in the range 1 through 32 to specify the number of the system or basic user ASP to provide storage for the queue manager library, journal and journal receivers.

Independent auxiliary storage pools can be switched between systems to increase the availability of a queue manager. Refer to the IBM MQ documentation on configuring a queue manager for high availability.

ASP device (ASPDEV)

Specifies the auxiliary storage pool (ASP) device name where storage is allocated for the queue manager library, journal and journal receivers.

Note that the auxiliary storage pool device name identified in this parameter will not be used for the queue manager data files which are located in the integrated file system (IFS). To allocate queue manager data files in a specific auxiliary storage pool refer to the MQMDIRP parameter.

The possible values are:

*ASP: The storage for the queue manager library, journal and journal receivers is allocated from the system or basic user ASP specified for the ASP parameter.
device-name: Specify the name of a primary or secondary ASP device. The storage for the queue manager library, journal and journal receivers is allocated from the primary or secondary ASP. The primary or secondary ASP must have already been activated (by varying on the ASP device) and have a status of 'Available'.

Journal receiver threshold (THRESHOLD)

Specifies the threshold in kilobytes for the queue managers journal receivers.

The possible values are:

*DFT: Use the default threshold of 100000 KB.
threshold-value: Specify a value in the range 100000 through 1000000000 in kilobytes (KB) of storage. Each 1000 KB specifies 1024000 bytes of storage space. When the size of the space for the journal receiver is larger than the size specified by this value, a message is sent to the identified message queue if appropriate, and journaling continues.

Journal buffer size (JRNBUFSIZ)

Specifies the journal buffer size in bytes

The possible values are:

*DFT: Use the default journal buffer size of 32000 bytes.
journal-buffer-size: Specify a value in bytes, in the range 32000 through 15761440.