Create Message Queue Manager (CRTMQM)

    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

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:


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'.

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.


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.


Examples

>

None


Error messages

>

Unknown

Parent topic: CL commands reference for IBM i