Work with MQ Cluster Queues (WRKMQMCLQ)

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

The Work with MQ Cluster Queues (WRKMQMCLQ) command allows you to work with cluster queues that are defined on the local queue manager.

Parameters

Keyword	Description	Choices	Notes
QNAME	Queue name	Character value, *ALL	Optional, Positional 1
MQMNAME	Message Queue Manager name	Character value, *DFT	Optional, Positional 2
CLUSTER	Cluster name	Character value, *ALL	Optional, Positional 3
WHERE	Filter command	Single values: *NONE Other values: Element list	Optional, Positional 4
	Element 1: Filter keyword	ALTDATE, ALTTIME, CLUSDATE, CLUSQMGR, CLUSQTYPE, CLUSTER, CLUSTIME, DEFBIND, DFTMSGPST, DFTPTY, PUTENBL, QMID, *TEXT
	Element 2: Filter operator	GT, LT, EQ, NE, GE, LE, LK, NL, CT, EX, CTG, EXG
	Element 3: Filter value	Character value

Queue name (QNAME)

Specifies the name or names of the cluster queue definitions.

*ALL: All cluster queue definitions are selected.
generic-queue-name: Specify the generic name of the MQ cluster queue definitions. A generic name is a character string followed by an asterisk (*). For example ABC*, it selects all cluster queue definitions having names that start with the character string. You are recommended to specify the name required within quotation marks. Using this format ensures that your selection is precisely what you entered. We cannot select all the uppercase and lowercase versions of a generic name on a single panel, without requesting all the names.
queue-name: Specify the name of the MQ cluster queue definition.

Message Queue Manager name (MQMNAME)

Specifies the name of the queue manager.

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

Cluster name (CLUSTER)

Specifies the name of the cluster.

*ALL: All cluster definitions are selected.
generic-cluster-name: Specify the generic name of the MQ cluster definitions. A generic name is a character string followed by an asterisk (*). For example ABC*, it selects all cluster definitions having names that start with the character string. You are recommended to specify the name required within quotation marks. Using this format ensures that your selection is precisely what you entered. We cannot select all the uppercase and lowercase versions of a generic name on a single panel, without requesting all the names.
cluster-name: Specify the name of the MQ cluster definition.

Filter command (WHERE)

This parameter can be used to selectively display only those cluster queues with particular cluster queue attributes.

The parameter takes three arguments, a keyword, an operator and a value.

Generic strings are allowed for values which are names.

The operator can take one of the following values:

*GT: Greater than.
Applicable to integer and non-generic string values.
*LT: Less than.
Applicable to integer and non-generic string values
*EQ: Equal to.
Applicable to integer and non-generic string values.
*NE: Not equal to.
Applicable to integer and non-generic string values.
*GE: Greater than or equal to.
Applicable to integer and non-generic string values.
*LE: Less than or equal to.
Applicable to integer and non-generic string values.
*LK: Like.
Applicable to generic string values.
*NL: Not like.
Applicable to generic string values.
*CT: Contains.
Applicable to non-generic list values.
*EX: Excludes.
Applicable to non-generic list values.
*CTG: Contains generic.
Applicable to generic list values.
*EXG: Excludes generic.
Applicable to generic list values.

The keyword can take one of the following values:

*ALTDATE

The date on which the definition or information was last altered.

The filter value is the data in the form yyyy-mm-dd.

*ALTTIME

The time at which the definition or information was last altered.

The filter value is the time in the form hh:mm:ss.

*CLUSDATE

The date on which the definition became available to the local queue manager.

The filter value is the date in the form yyyy-mm-dd.

*CLUSQMGR

The name of the queue manager that hosts the queue.

The filter value is the name of the queue manager.

*CLUSQTYPE

Cluster queue type.

The filter value is one of the following:

*LCL: The cluster queue represents a local queue.
*ALS: The cluster queue represents an alias queue.
*RMT: The cluster queue represents a remote queue.
*MQMALS: The cluster queue represents a queue manager alias.

*CLUSTER

The name of the cluster that the queue is in.

The filter value is the name of the cluster.

*CLUSTIME

The time at which the definition became available to the local queue manager.

The filter value is the time in the form hh:mm:ss.

*DEFBIND

Default message binding.

The filter value is one of the following:

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

*DFTMSGPST

Default persistence of the messages put on this queue.

The filter value is one of the following:

*NO: Messages on this queue are lost across a restart of the queue manager.
*YES: Messages on this queue survive a restart of the queue manager.

*DFTPTY

Default priority of the messages put on the queue.

The filter value is the integer priority value.

*PUTENBL

Whether applications are permitted to put messages to the queue.

The filter value is one of the following:

*NO: Messages cannot be added to the queue.
*YES: Messages can be added to the queue by authorized applications.

*QMID

Internally generated unique name of the queue manager that hosts the queue.

The filter value is the name of the queue manager.

*TEXT

Descriptive comment.

The filter value is the text description of the queue.

Examples

None

Error messages

Unknown