Air Cleaner User Manual

Usage notes
1. For alias queues:
a. DEFINE QALIAS(otherqname) TARGQ(aliasqueue) CLUSTER(c) has the effect of
advertising queue aliasqueue by the name otherqname.
b. DEFINE QALIAS(otherqname) TARGQ(aliasqueue) has the effect of allowing a
queue advertised by the name otherqname to be used on this queue
manager by the name aliasqueue.
2. For remote queues:
a. DEFINE QREMOTE(rqueue) RNAME(otherq) RQMNAME(otherqm) CLUSTER(cl) has
the effect of advertising this queue manager as a store and forward gateway
to which messages for queue rqueue can be sent. It has no effect as a
reply-to queue alias, except on the local queue manager.
DEFINE QREMOTE(otherqm) RNAME() RQMNAME(anotherqm) XMITQ(xq) CLUSTER
has the effect of advertising this queue manager as a store and forward
gateway to which messages for anotherqm can be sent.
b. RQMNAME can itself be the name of a cluster queue manager within the
cluster, thus (as with QALIAS definitions) you can map the advertised
queue manager name to another name locally.
c. It is possible for the values of RQMNAME and QREMOTE to be the same if
RQMNAME is itself a cluster queue manager. If this definition is also
advertised using a CLUSTER attribute, care should be taken not to choose
the local queue manager in the cluster workload exit because a cyclic
definition will result.
d. Remote queues do not have to be defined locally. The advantage of doing
so is that applications can refer to the queue by a simple, locally-defined
name, rather than by one that is qualified by the ID of the queue manager
on which the queue resides. This means that applications do not need to be
aware of the real location of the queue.
e. A remote queue definition can also be used as a mechanism for holding a
queue-manager alias definition, or a reply-to queue alias definition. The
name of the definition in these cases is:
v The queue-manager name being used as the alias for another
queue-manager name (queue-manager alias), or
v The queue name being used as the alias for the reply-to queue (reply-to
queue alias).
Usage notes
Chapter 2. The MQSeries commands 131