[IBM i]

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

Table 1. Command 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, you 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 you 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 you 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. You 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; you 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
Monitoring data collection is turned on with a low ratio of data collection.
*MEDIUM
Monitoring data collection is turned on with a moderate ratio of data collection.
*HIGH
Monitoring 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
Specifying 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
Specifying 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. You 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, you 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.