Queue definition commands
Cluster attributes that can be specified on the queue definition commands.
The DEFINE QLOCAL
, DEFINE QREMOTE
, and DEFINE QALIAS
commands
DEFINE QLOCAL
, DEFINE QREMOTE
, and DEFINE QALIAS
commands, and the three equivalent ALTER commands, are:- CLUSTER
- Specifies the name of the cluster to which the queue belongs.
- CLUSNL
- Specifies a namelist of cluster names.
- DEFBIND
- Specifies the binding to be used when an application specifies
MQOO_BIND_AS_Q_DEF
on the MQOPEN call. The options for this attribute are:- Specify
DEFBIND(OPEN)
to bind the queue handle to a specific instance of the cluster queue when the queue is opened.DEFBIND(OPEN)
is the default for this attribute. - Specify
DEFBIND(NOTFIXED)
so that the queue handle is not bound to any instance of the cluster queue. - Specify
DEFBIND(GROUP)
to allow an application to request that a group of messages are all allocated to the same destination instance.
- Specify
- CLWLRANK
- Applies a ranking factor to a queue for workload management purposes. CLWLRANK parameter is not supported on model queues. The cluster workload algorithm selects a destination queue with the highest rank. By default CLWLRANK for all queues is set to zero.
- CLWLPRTY
- Applies a priority factor to a queue for workload management purposes. The cluster workload algorithm selects a destination queue with the highest priority. By default priority for all queues is set to zero.
- CLWLUSEQ
- Specifies the behavior of an MQPUT operation for a queue. This parameter specifies the behavior of an MQPUT operation when the target queue has a local instance and at least one remote cluster instance (except where the MQPUT originates from a cluster channel). This parameter is only valid for local queues.
The DISPLAY QUEUE
and DISPLAY QCLUSTER
commands
The attributes on the DEFINE QLOCAL
, DEFINE QREMOTE
, and DEFINE QALIAS
commands also apply to the DISPLAY QUEUE
command.
To display information about cluster queues, specify a queue type of QCLUSTER or the keyword CLUSINFO on the DISPLAY QUEUE
command, or use the command DISPLAY QCLUSTER
.
The DISPLAY QUEUE
or DISPLAY QCLUSTER
command returns the name of the queue manager that hosts the queue (or the names of all queue managers if there is more than one instance of the queue). It also returns the system name for each queue manager that hosts the queue, the queue type represented, and the date and time at which the definition became available to the local queue manager. This information is returned using the CLUSQMGR, QMID, CLUSQT, CLUSDATE, and CLUSTIME attributes.
The system name for the queue manager ( QMID ), is a unique, system-generated name for the queue manager.
DEFINE QLOCAL(MYQUEUE) CLUSTER(MYCLUSTER) QSGDISP(SHARED) CFSTRUCT(STRUCTURE)
The equivalent PCFs are MQCMD_CHANGE_Q
, MQCMD_COPY_Q
, MQCMD_CREATE_Q
, and MQCMD_INQUIRE_Q
.