Configure workload balancing from outside a cluster

Configure a message path from a queue manager outside a cluster to any copy of a cluster queue. The result is to workload balance requests from outside the cluster to each instance of a cluster queue.

Before starting

Configure the example, as shown in Figure 1 in Configure request/reply to a cluster.

About this task

In this scenario, the queue manager outside the cluster, QM3 in Figure 1, sends requests to the queue Q2. Q2 is hosted on two queue managers, QM2 and QM4 within cluster DEMO. Both queue managers are configured with a default bind option of NOTFIXED in order to use workload balancing. The requests from QM3, the queue manager outside the cluster, are sent to either instance of Q2 through QM1.

QM3 is not part of a cluster and communicates using distributed queuing techniques. It must have a sender-channel and a transmission queue to QM1. QM1 needs a corresponding receiver-channel. The channels and transmission queues are not shown explicitly in Figure 1.

The procedure extends the example in Figure 1 in Configure request/reply to a cluster.

Procedure

1. Create a QREMOTE definition for Q2 on QM3.

   DEFINE QREMOTE(Q2) RNAME(Q2) RQMNAME(Q3) XMITQ(QM1)
   

   Create a QREMOTE definition for each queue in the cluster that QM3 puts messages to.
2. Create a queue manager alias Q3 on QM1.

   DEFINE QREMOTE(Q3) RNAME(' ') RQMNAME(' ')
   

   Q3 is not a real queue manager name. It is the name of a queue manager alias definition in the cluster that equates the queue manager alias name Q3 with blank, ' '
3. Define a local queue called Q2 on each of QM2 and QM4.

   DEFINE QLOCAL(Q2) CLUSTER(DEMO) DEFBIND(NOTFIXED)
   

4. QM1, the gateway queue manager, has no special definitions.

Results

When an application at QM3 issues an MQPUT call to put a message to Q2, the QREMOTE definition on QM3 causes the message to be routed through the gateway queue manager QM1. When QM1 receives the message, it is aware that the message is still intended for a queue named Q2 and performs name resolution. QM1 checks its local definitions and does not find any for Q2. QM1 then checks its cluster configuration and finds that it is aware of two instances of Q2 in cluster DEMO. QM1 can now make use of workload balancing to distribute messages between the instances of Q2 residing on QM2 and QM4.

Parent topic: Routing messages to and from clusters

Related concepts

• Queue manager aliases and clusters
• Reply-to queue aliases and clusters
• Queue aliases and clusters

Related tasks

• Configure request/reply to a cluster
• Configure request/reply from a cluster
• Configure message paths between clusters

Related information

• Queue name resolution
• Name resolution