Create MQ Queue (CRTMQMQ)

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

The Create MQ Queue (CRTMQMQ) command creates a queue definition with the specified attributes. All attributes that are not specified are set to the default value for the type of queue that is created.

Parameters

Keyword	Description	Choices	Notes
QNAME	Queue name	Character value	Required, Key, Positional 1
QTYPE	Queue type	ALS, LCL, MDL, RMT	Required, Key, Positional 2
MQMNAME	Message Queue Manager name	Character value, *DFT	Optional, Key, Positional 3
REPLACE	Replace	NO, YES	Optional, Positional 4
TEXT	Text 'description'	Character value, BLANK, SYSDFTQ	Optional, Positional 5
PUTENBL	Put enabled	SYSDFTQ, NO, *YES	Optional, Positional 6
DFTPTY	Default message priority	0-9, *SYSDFTQ	Optional, Positional 7
DFTMSGPST	Default message persistence	SYSDFTQ, NO, *YES	Optional, Positional 8
PRCNAME	Process name	Character value, NONE, SYSDFTQ	Optional, Positional 9
TRGENBL	Triggering enabled	SYSDFTQ, NO, *YES	Optional, Positional 10
GETENBL	Get enabled	SYSDFTQ, NO, *YES	Optional, Positional 11
SHARE	Sharing enabled	SYSDFTQ, NO, *YES	Optional, Positional 12
DFTSHARE	Default share option	SYSDFTQ, NO, *YES	Optional, Positional 13
MSGDLYSEQ	Message delivery sequence	SYSDFTQ, PTY, *FIFO	Optional, Positional 14
HDNBKTCNT	Harden backout count	SYSDFTQ, NO, *YES	Optional, Positional 15
TRGTYPE	Trigger type	SYSDFTQ, FIRST, ALL, DEPTH, *NONE	Optional, Positional 16
TRGDEPTH	Trigger depth	1-999999999, *SYSDFTQ	Optional, Positional 17
TRGMSGPTY	Trigger message priority	0-9, *SYSDFTQ	Optional, Positional 18
TRGDATA	Trigger data	Character value, NONE, SYSDFTQ	Optional, Positional 19
RTNITV	Retention interval	0-999999999, *SYSDFTQ	Optional, Positional 20
MAXDEPTH	Maximum queue depth	0-999999999, *SYSDFTQ	Optional, Positional 21
MAXMSGLEN	Maximum message length	0-104857600, *SYSDFTQ	Optional, Positional 22
BKTTHLD	Backout threshold	0-999999999, *SYSDFTQ	Optional, Positional 23
BKTQNAME	Backout requeue name	Character value, NONE, SYSDFTQ	Optional, Positional 24
INITQNAME	Initiation queue	Character value, NONE, SYSDFTQ	Optional, Positional 25
USAGE	Usage	SYSDFTQ, NORMAL, *TMQ	Optional, Positional 26
DFNTYPE	Definition type	SYSDFTQ, TEMPDYN, *PERMDYN	Optional, Positional 27
TGTQNAME	Target object	Character value, *SYSDFTQ	Optional, Positional 28
RMTQNAME	Remote queue	Character value, SYSDFTQ, NONE	Optional, Positional 29
RMTMQMNAME	Remote Message Queue Manager	Character value, *SYSDFTQ	Optional, Positional 30
TMQNAME	Transmission queue	Character value, NONE, SYSDFTQ	Optional, Positional 31
HIGHTHLD	Queue depth high threshold	0-100, *SYSDFTQ	Optional, Positional 32
LOWTHLD	Queue depth low threshold	0-100, *SYSDFTQ	Optional, Positional 33
FULLEVT	Queue full events enabled	SYSDFTQ, NO, *YES	Optional, Positional 34
HIGHEVT	Queue high events enabled	SYSDFTQ, NO, *YES	Optional, Positional 35
LOWEVT	Queue low events enabled	SYSDFTQ, NO, *YES	Optional, Positional 36
SRVITV	Service interval	0-999999999, *SYSDFTQ	Optional, Positional 37
SRVEVT	Service interval events	SYSDFTQ, HIGH, OK, NONE	Optional, Positional 38
DISTLIST	Distribution list support	SYSDFTQ, NO, *YES	Optional, Positional 39
CLUSTER	Cluster Name	Character value, SYSDFTQ, NONE	Optional, Positional 40
CLUSNL	Cluster Name List	Character value, NONE, SYSDFTQ	Optional, Positional 41
DEFBIND	Default Binding	SYSDFTQ, OPEN, NOTFIXED, GROUP	Optional, Positional 42
CLWLRANK	Cluster Workload Rank	0-9, *SYSDFTQ	Optional, Positional 43
CLWLPRTY	Cluster Workload Priority	0-9, *SYSDFTQ	Optional, Positional 44
CLWLUSEQ	Cluster workload queue use	SYSDFTQ, QMGR, LOCAL, ANY	Optional, Positional 45
MONQ	Queue Monitoring	SYSDFTQ, QMGR, OFF, LOW, MEDIUM, HIGH	Optional, Positional 46
STATQ	Queue Statistics	SYSDFTQ, QMGR, OFF, ON	Optional, Positional 47
ACCTQ	Queue Accounting	SYSDFTQ, QMGR, OFF, ON	Optional, Positional 48
NPMCLASS	Non Persistent Message Class	SYSDFTQ, NORMAL, *HIGH	Optional, Positional 49
MSGREADAHD	Message Read Ahead	SYSDFTQ, DISABLED, NO, YES	Optional, Positional 50
DFTPUTRESP	Default Put Response	SYSDFTQ, SYNC, *ASYNC	Optional, Positional 51
PROPCTL	Property Control	SYSDFTQ, COMPAT, NONE, ALL, FORCE, V6COMPAT	Optional, Positional 52
TARGTYPE	Target Type	SYSDFTQ, QUEUE, *TOPIC	Optional, Positional 53
CUSTOM	Custom attribute	Character value, BLANK, SYSDFTQ	Optional, Positional 54
CLCHNAME	Cluster-sender channel name	Character value, NONE, SYSDFTQ	Optional, Positional 55
IMGRCOVQ	Queue object attribute	SAME, NO, YES, QMGR	Optional, Positional 57

Queue name (QNAME)

Specifies the name of the queue definition. Queue names must be unique. If a queue definition with this name already exists, we must specify REPLACE(*YES).

The name can contain up to 48 characters.

Note: The field length is 48 bytes and the maximum number of characters is reduced if the system is using a double byte character set (DBCS).

The possible values are:

queue-name: Specify the name of the new queue.

Queue type (QTYPE)

Specifies the type of queue that is to be created.

If the queue already exists, REPLACE(*YES) must be specified, and the value specified by QTYPE must be the type of the existing queue.

The possible values are:

*ALS: An alias queue.
*LCL: A local queue.
*RMT: A remote queue.
*MDL: A model queue.

Message Queue Manager name (MQMNAME)

Specifies the name of the message queue manager.

The possible values are:

*DFT: Use the default queue manager.
queue-manager-name: Specify the name of the queue manager.

Replace (REPLACE)

Specifies whether the new queue will replace an existing queue definition with the same name and type.

The possible values are:

*NO

Do not replace the existing queue. The command fails if the named queue already exists.

*YES

Replace the existing queue definition with the attributes of the FROMQ and the specified attributes.

The command will fail if an application has the Queue open or the USAGE attribute is changed.

Note: If the queue is a local queue, and a queue with the same name already exists, any messages already on that queue are retained.

Text 'description' (TEXT)

Specifies text that briefly describes the queue definition.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*BLANK: The text is set to a blank string.
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).

Put enabled (PUTENBL)

Specifies whether messages can be put on the queue.

Note: An application program can issue a call to MQSET to change the value of this attribute.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*NO: Messages cannot be added to the queue.
*YES: Messages can be added to the queue by authorized applications.

Default message priority (DFTPTY)

Specifies the default priority of messages put on the queue.

The possible values are:

*SYSDFTQ: The value of this attribute taken from the system default queue of the specified type.
priority-value: Specify a value ranging from 0 through 9.

Default message persistence (DFTMSGPST)

Specifies the default for message-persistence on the queue. Message persistence determines whether messages are preserved across restarts of the queue manager.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*NO: By default, messages are lost across a restart of the queue manager.
*YES: By default, messages are preserved across a restart of the queue manager.

Process name (PRCNAME)

Specifies the local name of the MQ process that identifies the application that should be started when a trigger event occurs.

The process does not have to be available when the queue is created, but it must be available for a trigger event to occur.

The possible values are:

*SYSDFTQ: The value of this attribute taken from the system default queue of the specified type.
*NONE: No process is specified.
process-name: Specify the name of the process.

Triggering enabled (TRGENBL)

Specifies whether trigger messages are written to the initiation queue.

Note: An application program can issue a call to MQSET to change the value of this attribute.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*NO: Do not write trigger messages to the initiation queue.
*YES: Triggering is active; trigger messages are written to the initiation queue.

Get enabled (GETENBL)

Specifies whether applications are to be permitted to get messages from this queue.

Note: An application program can issue a call to MQSET to change the value of this attribute.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*NO: Applications cannot retrieve messages from the queue.
*YES: Suitably authorized applications can retrieve messages from the queue.

Sharing enabled (SHARE)

Specifies whether multiple instances of applications can open this queue for input.

The possible values are:

*SYSDFTQ: The value of this attribute is from the system default queue of the specified type.
*NO: Only a single application instance can open the queue for input.
*YES: More than one application instance can open the queue for input.

Default share option (DFTSHARE)

Specifies the default share option for applications opening this queue for input.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*NO: The open request is for exclusive use of the queue for input.
*YES: The open request is for shared use of the queue for input.

Message delivery sequence (MSGDLYSEQ)

Specifies the message delivery sequence.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*PTY: Messages are delivered in first-in-first-out (FIFO) order within priority.
*FIFO: Messages are delivered in FIFO order regardless of priority.

Harden backout count (HDNBKTCNT)

Specifies whether the count of backed out messages should be saved (hardened) across restarts of the message queue manager.

Note: On IBM MQ for IBM i the count is ALWAYS hardened, regardless of the setting of this attribute.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*NO: The backout count is not hardened.
*YES: The backout count is hardened.

Trigger type (TRGTYPE)

Specifies the condition that initiates a trigger event. When the condition is true, a trigger message is sent to the initiation queue.

Note: An application program can issue a call to MQSET to change the value of this attribute.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*FIRST: When the number of messages on the queue goes from zero to one.
*ALL: Every time a message arrives on the queue.
*DEPTH: When the number of messages on the queue equals the value of the TRGDEPTH attribute.
*NONE: No trigger messages are written.

Trigger depth (TRGDEPTH)

Specifies, for TRIGTYPE(*DEPTH), the number of messages that initiate a trigger message to the initiation queue.

Note: An application program can issue a call to MQSET to change the value of this attribute.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
depth-value: Specify a value ranging from 1 through 999999999.

Trigger message priority (TRGMSGPTY)

Specifies the minimum priority that a message must have before it can produce, or be counted for, a trigger event.

Note: An application program can issue a call to MQSET to change the value of this attribute.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
priority-value: Specify a value ranging from 0 through 9.

Trigger data (TRGDATA)

Specifies up to 64 characters of user data that the queue manager includes in the trigger message. This data is made available to the monitoring application that processes the initiation queue and to the application started by the monitor.

Note: An application program can issue a call to MQSET to change the value of this attribute.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*NONE: No trigger data is specified.
trigger-data: Specify up to 64 characters enclosed in apostrophes. For a transmission queue we can use this parameter to specify the name of the channel to be started.
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).

Retention interval (RTNITV)

Specifies the retention interval. This interval is the number of hours for which the queue might be needed, based on the date and time when the queue was created.

This information is available to a housekeeping application or an operator and can be used to determine when a queue is no longer required.

Note: The message queue manager does not delete queues, nor does it prevent your queues from being deleted if their retention interval has not expired. It is your responsibility to take any required action.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
interval-value: Specify a value ranging from 0 through 999999999.

Maximum queue depth (MAXDEPTH)

Specifies the maximum number of messages allowed on the queue. However, other factors can cause the queue to be treated as full; for example, it appears to be full if there is no storage available for a message.

Note: If this value is subsequently reduced by using the CHGMQMQ command, any messages that are on the queue remain intact even if they cause the new maximum to be exceeded.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
depth-value: Specify a value ranging from 0 through 999999999.

Maximum message length (MAXMSGLEN)

Specifies the maximum length for messages on the queue.

Note: If this value is subsequently reduced by using the CHGMQMQ command, any messages that are on the queue remain intact even if they exceed the new maximum length.

Applications might use the value of this attribute to determine the size of buffer they need to retrieve messages from the queue. Therefore change the value only if you know this will not cause an application to operate incorrectly.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified queue type.
length-value: Specify a value ranging from 0 through 104 857 600.

Backout threshold (BKTTHLD)

Specifies the backout threshold.

Applications running inside of WebSphere Application Server and those that use the IBM MQ Application Server Facilities will use this attribute to determine if a message should be backed out. For all other applications, apart from allowing this attribute to be queried, the queue manager takes no action based on the value of the attribute.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified queue type.
threshold-value: Specify a value ranging from 0 through 999999999.

Backout requeue name (BKTQNAME)

Specifies the backout-queue name.

Applications running inside of WebSphere Application Server and those that use the IBM MQ Application Server Facilities will use this attribute to determine where messages that have been backed out should go. For all other applications, apart from allowing this attribute to be queried, the queue manager takes no action based on the value of the attribute.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified queue type.
*NONE: No backout queue is specified.
backout-queue-name: Specify the backout queue name.

Initiation queue (INITQNAME)

Specifies the name of the initiation queue.

Note: The initiation queue must be on the same instance of a message queue manager.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified queue type.
*NONE: No initiation queue is specified.
initiation-queue-name: Specify the initiation queue name.

Usage (USAGE)

Specifies whether the queue is for normal usage, or for transmitting messages to a remote message queue manager.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified queue type.
*NORMAL: Normal usage (the queue is not a transmission queue)
*TMQ: The queue is a transmission queue that is used to hold messages destined for a remote message queue manager. If the queue is intended for use in situations where a transmission queue name is not explicitly specified, the queue name must be the same as the name of the remote message queue manager. For further information, see the IBM MQ Intercommunication.

Definition type (DFNTYPE)

Specifies the type of dynamic queue definition that is created when an application issues an MQOPEN API call with the name of this model queue specified in the object descriptor.

Note: This parameter only applies to a model queue definition.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*TEMPDYN: Creates a temporary dynamic queue. Do not specify with a DEFMSGPST value of *YES.
*PERMDYN: Creates a permanent dynamic queue.

Target object (TGTQNAME)

Specifies the name of the target object for which this queue is an alias.

The object can be a local or remote queue, a topic or a message queue manager.

Do not leave this field blank. If you do so, it is possible that we will create an alias queue, that has to be subsequently modified, by the addition of a TGTNAME.

When a message queue manager name is specified, it identifies the message queue manager that handles the messages posted to the alias queue. We can specify either the local message queue manager or a transmission queue name.

Note: The target object does not need to exist at this time but it must exist when a process attempts to open the alias queue.

The possible values are:

*SYSDFTQ: The name of the target object is taken from the SYSTEM.DEFAULT.ALIAS.QUEUE.
target-object-name: Specify the name of the target object.

Remote queue (RMTQNAME)

Specifies the name of the remote queue. That is, the local name of the remote queue as defined on the queue manager specified by RMTMQMNAME.

If this definition is used for a queue manager alias definition, RMTQNAME must be blank when the open occurs.

If this definition is used for a reply-to alias, this name is the name of the queue that is to be the reply-to queue.

The possible values are:

*SYSDFTQ: The name of the remote queue is taken from the SYSTEM.DEFAULT.REMOTE.QUEUE.
*NONE: No remote-queue name is specified (that is, the name is blank). This can be used if the definition is a queue manager alias definition.
remote-queue-name: Specify the name of the queue at the remote queue manager.
Note: The name is not checked to ensure that it contains only those characters normally allowed for queue names

Remote Message Queue Manager (RMTMQMNAME)

Specifies the name of the remote queue manager on which the queue RMTQNAME is defined.

If an application opens the local definition of a remote queue, RMTMQMNAME must not be the name of the connected queue manager. If TMQNAME is blank there must be a local queue of this name, which is to be used as the transmission queue.

If this definition is used for a queue manager alias, RMTMQMNAME is the name of the queue manager, which can be the name of the connected queue manager. Otherwise, if TMQNAME is blank, when the queue is opened there must be a local queue of this name, with USAGE(*TMQ) specified, which is to be used as the transmission queue.

If this definition is used for a reply-to alias, this name is the name of the queue manager that is to be the reply-to queue manager.

The possible values are:

*SYSDFTQ: The name of the remote queue manager is taken from the SYSTEM.DEFAULT.REMOTE.QUEUE.
remote-queue-manager-name: Specify the name of the remote queue manager.
Note: Ensure this name contains only those characters normally allowed for queue manager names.

Transmission queue (TMQNAME)

Specifies the local name of the transmission queue to be used for messages destined for the remote queue, for either a remote queue or for a queue manager alias definition.

If TMQNAME is blank, a queue with the same name as RMTMQMNAME is used as the transmission queue.

This attribute is ignored if the definition is being used as a queue manager alias and RMTMQMNAME is the name of the connected queue manager.

It is also ignored if the definition is used as a reply-to queue alias definition.

The possible values are:

*SYSDFTQ: The transmission queue name is taken from the SYSTEM.DEFAULT.REMOTE.QUEUE.
*NONE: No specific transmission queue name is defined for this remote queue. The value of this attribute is set to all blanks.
transmission-queue-name: Specify the transmission queue name.

Queue depth high threshold (HIGHTHLD)

Specifies the threshold against which the queue depth is compared to generate a queue depth high event.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
threshold-value: Specify a value ranging from 0 through 100. This value is used as a percentage of the maximum queue depth (MAXDEPTH parameter).

Queue depth low threshold (LOWTHLD)

Specifies the threshold against which the queue depth is compared to generate a queue depth low event.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
threshold-value: Specify a value ranging from 0 through 100. This value is used as a percentage of the maximum queue depth (MAXDEPTH parameter).

Queue full events enabled (FULLEVT)

Specifies whether queue full events are generated.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*NO: Queue Full events are not generated.
*YES: Queue Full events are generated.

Queue high events enabled (HIGHEVT)

Specifies whether queue depth high events are generated.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*NO: Queue Depth High events are not generated.
*YES: Queue Depth High events are generated.

Queue low events enabled (LOWEVT)

Specifies whether queue depth low events are generated.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*NO: Queue Depth Low events are not generated.
*YES: Queue Depth Low events are generated.

Service interval (SRVITV)

Specifies the service interval. This interval is used for comparison to generate service interval high and service interval OK events.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
interval-value: Specify a value ranging from 0 through 999999999. The value is in units of milliseconds.

Service interval events (SRVEVT)

Specifies whether service interval high or service interval OK events are generated.

A service interval high event is generated when a check indicates that no messages have been retrieved from the queue for the time indicated by the SRVITV parameter as a minimum.

A service interval OK event is generated when a check indicates that messages have been retrieved from the queue within the time indicated by the SRVITV parameter.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*HIGH: Service Interval High events are generated.
*OK: Service Interval OK events are generated.
*NONE: No service interval events are generated.

Distribution list support (DISTLIST)

Specifies whether the queue supports distribution lists.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*NO: Distribution Lists are not supported.
*YES: Distribution Lists are supported.

Cluster Name (CLUSTER)

The name of the cluster to which the queue belongs.

Changes to this parameter do not affect instances of the queue that are already open.

This parameter cannot be set for dynamic, transmission, SYSTEM.CHANNEL.xx, SYSTEM.CLUSTER.xx or SYSTEM.COMMAND.xx queues.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
cluster-name: Only one of the resultant values of CLUSTER or CLUSNL can be non-blank; we cannot specify a value for both.

Cluster Name List (CLUSNL)

The name of the namelist which specifies a list of clusters to which the queue belongs. Changes to this parameter do not affect instances of the queue that are already open.

This parameter cannot be set for dynamic, transmission, SYSTEM.CHANNEL.xx, SYSTEM.CLUSTER.xx or SYSTEM.COMMAND.xx queues.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
namelist-name: The name of the namelist that specifies a list of clusters to which the queue belongs.

Default Binding (DEFBIND)

Specifies the binding to be used when the application specifies MQOO_BIND_AS_Q_DEF on the MQOPEN call and the queue is a cluster queue.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*OPEN: The queue handle is bound to a specific instance of the cluster queue when the queue is opened.
*NOTFIXED: The queue handle is not bound to any particular instance of the cluster queue. This allows the queue manager to select a specific queue instance when the message is put using MQPUT and to change that selection subsequently if necessary.
The MQPUT1 call always behaves as if NOTFIXED had been specified.
*GROUP: When the queue is opened, the queue handle is bound to a specific instance of the cluster queue for as long as there are messages in a message group. All messages in a message group are allocated to the same destination instance.

Cluster Workload Rank (CLWLRANK)

Specifies the cluster workload rank of the queue.

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
cluster-workload-rank: Specify a value ranging from 0 through 9.

Cluster Workload Priority (CLWLPRTY)

Specifies the cluster workload priority of the queue.

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
cluster-workload-priority: Specify a value ranging from 0 through 9.

Cluster workload queue use (CLWLUSEQ)

Specifies the behavior of an MQPUT when the target queue has both a local instance and at least one remote cluster instance. If the put originates from a cluster channel then this attribute does not apply.

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*QMGR: The value is inherited from the Queue Manager CLWLUSEQ attribute.
*LOCAL: The local queue will be the sole target of the MQPUT.
*ANY: The queue manager will treat such a local queue as another instance of the cluster queue for the purposes of workload distribution.

Queue Monitoring (MONQ)

Controls the collection of Online Monitoring Data.

Online Monitoring Data is not collected when the queue manager attribute MONQ is set to *NONE.

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*QMGR: The collection of Online Monitoring Data is inherited from the setting of the queue manager attribute MONQ.
*OFF: Online Monitoring Data collection for this queue is disabled.
*LOW: Monitor data collection is turned on with a low ratio of data collection.
*MEDIUM: Monitor data collection is turned on with a moderate ratio of data collection.
*HIGH: Monitor data collection is turned on with a high ratio of data collection.

Queue Statistics (STATQ)

Controls the collection of statistics data.

Online monitoring data is not collected when the queue manager attribute STATQ is set to *NONE.

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*QMGR: Statistics data collection is based upon the setting of the queue manager attribute STATQ.
*OFF: Statistics data collection for this queue is disabled.
*ON: Statistics data collection is enabled for this queue.

Queue Accounting (ACCTQ)

Controls the collection of accounting data.

Accounting data is not collected when the queue manager attribute ACCTQ is set to *NONE.

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*QMGR: Accounting data collection is based upon the setting of the queue manager attribute ACCTQ.
*OFF: Accounting data collection for this queue is disabled.
*ON: Accounting data collection is enabled for this queue.

Non Persistent Message Class (NPMCLASS)

Specifies the level of reliability for non-persistent messages put to this queue.

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*NORMAL: Non-persistent messages put to this queue are only lost following a failure, or a queue manager shutdown. Non-persistent message put to this queue are discarded in the event of a queue manager restart.
*HIGH: Non-persistent messages put to this queue are not discarded in the event of a queue manager restart. Non-persistent messages put to this queue may still be lost in the event of a failure.

Message Read Ahead (MSGREADAHD)

Specifies whether nonpersistent messages are sent to the client ahead of an application requesting them.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*DISABLED: Read ahead is disabled for this queue. Messages are not sent to the client ahead of an application requesting them regardless of whether read ahead is requested by the client application.
*NO: Non-persistent messages are not sent to the client ahead of an application requesting them. A maximum of one non-persistent message can be lost if the client ends abnormally.
*YES: Non-persistent messages are sent to the client ahead of an application requesting them. Non-persistent messages can be lost if the client ends abnormally or if the client application does not consume all the messages it is sent.

Default Put Response (DFTPUTRESP)

The default put response type (DFTPUTRESP) attribute specifies the type of response required for MQPUT and MQPUT1 calls when applications specify the MQPMO_RESPONSE_AS_Q_DEF option.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*SYNC: Specify this value ensures that the put operations to the queue that specify MQPMO_RESPONSE_AS_Q_DEF are issued as if MQPMO_SYNC_RESPONSE had been specified instead. Fields in the MQMD and MQPMO are returned by the queue manager to the application. This is the default value supplied with IBM MQ, but your installation might have changed it.
*ASYNC: Specify this value ensures that the put operations to the queue that specify MQPMO_RESPONSE_AS_Q_DEF are always issued as if MQPMO_ASYNC_RESPONSE had been specified instead. Some fields in the MQMD and MQPMO are not returned by the queue manager to the application; but an improvement in performance may be seen for messages put in a transaction or any non-persistent messages.

Property Control (PROPCTL)

Specifies what happens to properties of messages that are retrieved from queues using the MQGET call when the MQGMO_PROPERTIES_AS_Q_DEF option is specified.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*COMPAT: If the message contains a property with a prefix of mcd., jms., usr. or mqext. then all message properties are delivered to the application in an MQRFH2 header. Otherwise all properties of the message, except those contained in the message descriptor (or extension), are discarded and are no longer accessible to the application.
*NONE: All properties of the message, except those contained in the message descriptor (or extension), are discarded and are no longer accessible to the application.
*ALL: All properties of the message, except those contained in the message descriptor (or extension), are contained in one or more MQRFH2 headers in the message data.
*FORCE: Properties are always returned in the message data in an MQRFH2 header regardless of whether the application specifies a message handle.
*V6COMPAT: When set, *V6COMPAT must be set both on one of the queue definitions resolved by MQPUT and one of the queue definitions resolved by MQGET. It must also be set on any other intervening transmission queues. It causes an MQRFH2 header to be passed unchanged from the sending application to the receiving application. It overrides other settings of PROPCTL found in a queue name resolution chain. If the property is set on a cluster queue, the setting is not cached locally on other queue managers. We must set *V6COMPAT on an alias queue that resolves to the cluster queue. Define the alias queue on the same queue manager that the putting application is connected to.

Target Type (TARGTYPE)

Specifies the type of object to which the alias resolves.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*QUEUE: Queue object.
*TOPIC: Topic object.

Custom attribute (CUSTOM)

This attribute is reserved for the configuration of new features before separate attributes have been introduced. This description will be updated when features using this attribute are introduced. At the moment there are no meaningful values for CUSTOM, so leave it empty.

The possible values are:

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*BLANK: The text is set to a blank string.
custom: Specify zero or more attributes as pairs of attribute name and value, separated by at least one space. The attribute name-value pairs must have the form NAME(VALUE) and be specified in uppercase. Single quotes must be escaped with another single quote.

CLCHNAME

This parameter is supported only on transmission queues.

*SYSDFTQ: The value of this attribute is taken from the system default queue of the specified type.
*NONE: The attribute is removed.
custom: Specify zero or more attributes as pairs of attribute name and value, separated by at least one space. The attribute name-value pairs must have the form NAME(VALUE) and be specified in uppercase. Single quotes must be escaped with another single quote.

By specifying asterisks, *, in ClusterChannelName, we can associate a transmission queue with a set of cluster-sender channels. The asterisks can be at the beginning, end, or any number of places in the middle of the channel name string. ClusterChannelName is limited to a length of 20 characters: MQ_CHANNEL_NAME_LENGTH.

IMGRCOVQ

Specifies whether a local or permanent dynamic queue object is recoverable from a media image, if linear logging is being used.

The possible values are:

*SAME: The attribute is unchanged.
*YES: These queue objects are recoverable.
*NO: The Record MQ Object Image (RCDMQMIMG) and Re-create MQ Object (RCRMQMOBJ) commands are not permitted for these objects, and automatic media images, if enabled, are not written for these objects.
*QMGR: If you specify *QMGR, and the IMGRCOVQ attribute for the queue manager specifies *YES, these queue objects are recoverable.
If you specify *QMGR and the IMGRCOVQ attribute for the queue manager specifies *NO, the Record MQ Object Image (RCDMQMIMG) and Re-create MQ Object (RCRMQMOBJ) commands are not permitted for these objects, and automatic media images, if enabled, are not written for these objects.

Parent topic: CL commands reference for IBM i