使用 Websphere MQ 集群进行负载平衡

朴灿烈づ我的快乐病毒、 2022-05-27 00:26 369阅读 0赞

IBM WebSphere MQ (Message Queue) 是目前应用最多的消息中间件产品，它简化了应用程序之间的数据传输，提供了统一的通信标准，确保分布式网络环境下可靠的、跨平台的信息传输和数据交换。应用程序只需要将消息发送给 MQ，由 MQ 负责将消息安全可靠地发送出去。

Websphere MQ 支持集群功能。多个队列管理器可以分布在不同的机器上。集群功能简化了系统配置，不需要在每个队列管理器上创建消息通道、远程队列定义和传输队列。使用集群技术可以提高系统的可用性和实现负载均衡。

## MQ 集群概述 ##

对于 MQ 两个队列管理器之间的通信，需要创建相应的对象。在发送队列管理器上，要创建一个远程队列，这个远程队列指向远程的目的地队列。还要创建一个传输队列做为存储转发队列以及一个发送通道指向接收队列管理器。在接收队列管理器上，要创建一个本地队列和一个接收通道。如果一个网络中有多个队列管理器，并且两两之间要实现通信时，需要创建多个远程队列、传输队列和发送通道。

为了简化点对点通信的系统配置，通过 MQ 提供的群集功能，减少了集群中队列管理器上的 MQ 对象数量。群集内的两个队列管理器之间的通信，不需要两两间建立消息通道，而是使用群集通道与其它成员通信。只需要在每个队列管理器上创建两个集群通道。一个集群接收通道用来从集群中的其他队列管理器接收消息。一个集群发送通道用来发送消息。

集群的仓储库中含有集群的信息，如队列管理器的位置，通道等信息。仓储库分为完整仓储库队列管理器和部分仓储库队列管理器。完整仓储库队列管理器有集群中所有队列管理器的信息。而部分仓储库队列管理器中只有自身的和它要通信的队列管理器的信息。部分队列管理器通过与完整队列管理器通信，查询到相关的集群信息。

集群中共享的队列叫做集群队列。集群中的其他队列管理器可以向集群队列发送消息而不需要创建对应的远程队列定义。通常会在集群中创建多个同名的集群队列实例，分布在不同队列管理器上。当消息发送到集群队列时，MQ 会通过负载平衡算法，决定消息实际发送到哪里队列管理器的队列上。

## 创建 MQ 集群环境 ##

创建一个简单的 MQ 集群一般需要两个完整仓储库队列管理器和两个部分仓储库队列管理器。其中两个完整仓储库队列管理器相互形成备份。本文示例中包括，两个完整仓储库队列管理器和两个部分仓储库队列管理器，以及在两个部分仓储库队列管理器上各创建一个集群队列。

### 用命令行创建集群 ###

##### 清单 1. 创建队列管理器 #####

在清单 1 中，创建了一个队列管理器 FULL\_QM1。并且指定了这个队列管理器的监听端口为 5000。然后用同样的方法分别创建队列管理器 FULL\_QM2，PART\_QM1 和 PART\_QM2，指定队列管理器的监听端口为 5001，5002 和 5003。

在创建完队列管理器后，需要将 FULL\_QM1 和 FULL\_QM2 添加到集群 NEW\_CLUSTER 中，作为完整仓储库队列管理器。如清单 2 所示。

##### 清单 2. 添加完整仓储库定义 #####

在集群中，无论一个队列管理器要连接多少个远程队列管理器，最少只要创建一个集群发送通道和一个集群接收通道。

每个队列管理器都需要一个接收通道指向自己。对于队列管理器 FULL\_QM1，要指定连接名 CONNAME 中的 ip 地址和端口号为 FULL\_QM1 自己的 ip 地址和监听端口号。对于其他的队列管理器也一样。在清单 3 中，创建了集群中四个队列管理器的接收通道。

##### 清单 3. 在队列管理器上创建接收通道 #####

每个队列管理器需要一个发送通道。在清单 4 中，定义了集群中四个队列管理器的发送通道。需要注意的是，对于两个完整仓储库队列管理器，需要建立相互间的发送通道。如对于完整仓储库队列管理器 FULL\_QM1，需要建立到 FULL\_QM2 的发送通道，发送通道的名字要和 FULL\_QM2 的接收通道名字相同。并且要指定连接名 CONNAME 中的 ip 地址和端口号为 FULL\_QM2 的 ip 地址和端口号。

而对于部分仓储库队列管理器，需要建立与某个或多个完整仓储库队列管理器的发送通道。对于 PART\_QM1，这里建立了到完整仓储库队列管理器 FULL\_QM1 的发送通道，并且发送通道的名字要和 FULL\_QM1 的接收通道名字相同。连接名 CONNAME 也要指定为 FULL\_QM1 的 ip 地址和端口号。另外，不需要定义 PART\_QM1 指向另一个部分仓储库队列管理器 PART\_QM2 的发送通道。

##### 清单 4. 在队列管理器上创建发送通道 #####

集群的负载均衡是通过在集群内的不同队列管理器上建立同名的队列，即创建同一个队列的多个实例来实现的。每个队列实例都可以作为消息的目的地，MQ 使用负载平衡算法决定消息实际发送到哪个队列管理器。清单 5 中，在两个部分仓储库队列管理器上分别定义了一个集群队列 TEST\_QUEUE，并且指定其 Cluster 属性值为 NEW\_CLUSTER，这样这两个同名队列就可以在集群中共享了。

##### 清单 5. 在两个部分仓储库队列管理器上定义集群队列 #####

至此，已创建完一个简单的集群。可以通过 DISPLAY CLUSQMGR 命令来显示集群中的队列管理器的相关信息。清单 6 中列出了部分的信息。连接到完整仓储库队列管理器 FULL\_QM1，在结果中共显示了四条通道。其中 TO.FULL\_QM1 类型为 CLUSRCVR，指向 FULL\_QM1，是接收通道。TO.FULL\_QM2 为发送通道，指向 FULL\_QM2，类型 CLUSSDRB 说明是显示创建的。TO.PART\_QM1 和 TO.PART\_QM2 是发送通道，分别指向 PART\_QM1 和 PART\_QM2，类型都为 CLUSSDRA，是集群自动生成的。

##### 清单 6. 集群中队列管理器的信息 #####

通过 DISPLAY QUEUE 命令显示集群中队列的相关信息，如清单 7 所示。连接到完整仓储库队列管理器 FULL\_QM1 上，在结果中共显示了两个集群队列实例 TEST\_QUEUE。

##### 清单 7. 集群队列的信息 #####

通过这些命令，可以了解集群的具体结构。图 1 是当前显示创建的集群 NEW\_CLUSTER 的拓扑图。对于 PART\_QM1，我们只是显示创建了 PART\_QM1 到 FULL\_QM1 的发送通道，之后集群会自动创建 PART\_QM1 到 FULL\_QM2 的发送通道。同样集群也会自动创建 PART\_QM2 到 FULL\_QM1 的发送通道。最后形成的集群拓扑图如图 2 所示。

##### 图 1. 显示创建的集群 NEW\_CLUSTER 的拓扑图 #####

![图 1. 显示创建的集群 NEW\_CLUSTER 的拓扑图][1. _ NEW_CLUSTER]

##### 图 2. 集群 NEW\_CLUSTER 的拓扑图 #####

![图 2. 集群 NEW\_CLUSTER 的拓扑图][2. _ NEW_CLUSTER]

### 用 MQ explorer 创建集群 ###

与用命令行创建集群相比，用 MQ explorer 更直观，用来创建一个简单的集群比较方便。首先，在 MQ explorer 中选择队列管理器 -> 右键新建 -> 队列管理器，创建四个队列管理器，分别为 FULL\_QM1，FULL\_QM2，PART\_QM1 和 PART\_QM2。然后选择队列管理器集群 -> 右键新建 -> 队列管理器集群，创建集群 NEW\_CLUSTER。如图 3 所示。

##### 图 3. 创建集群 #####

![图 3. 创建集群][3.]

然后添加完整存储库队列管理器到集群。在添加到集群队列管理器选项中分别选择 FULL\_QM1 和 FULL\_QM2。如图 4 和图 5 所示。

##### 图 4. 选择第一个完整存储库队列管理器 #####

![图 4. 选择第一个完整存储库队列管理器][4.]

##### 图 5. 选择第二个完整存储库队列管理器 #####

![图 5. 选择第二个完整存储库队列管理器][5.]

在第一个完整存储库队列管理器 FULL\_QM1 上创建接收方通道，连接通道的端口号要设为 FULL\_QM1 的监听端口 5000。用同样的方法在第二个完整存储库队列管理器 FULL\_QM2 上创建接收方通道，如图 6 和图 7 所示。

##### 图 6. 在第一个完整存储库队列管理器上创建接收通道 #####

![图 6. 在第一个完整存储库队列管理器上创建接收通道][6.]

##### 图 7. 在第二个完整存储库队列管理器上创建接收通道 #####

![图 7. 在第二个完整存储库队列管理器上创建接收通道][7.]

至此，已经创建了集群 NEW\_CLUSTER。现在需要将两个部分存储库队列管理器 PART\_QM1 和 PART\_QM2 添加到集群。在 MQ explorer 中，选择新创建的集群 NEW\_CLUSTER-> 右键将队列集群管理器添加到集群，首先添加 PART\_QM1 到集群，并且选择为部分仓储库队列管理器，如图 8 和图 9 所示。

##### 图 8. 添加队列管理器到集群 #####

![图 8. 添加队列管理器到集群][8.]

##### 图 9. 选择为部分存储库 #####

![图 9. 选择为部分存储库][9.]

定义 PART\_QM1 队列管理器接收方通道时，需要将端口号指定为该队列管理器自身监听的端口号。如图 10 所示。

##### 图 10. 定义队列管理器的集群接收方通道 #####

![图 10. 定义队列管理器的集群接收方通道][10.]

由于部分仓储库队列管理器需要将信息同步到完整仓储库队列管理器，所以需要指定信息要发送到的完整仓储库队列管理器，可以选择 FULL\_QM1 或 FULL\_QM2 或都选择。这里选择 FULL\_QM1，如图 11 所示。然后用同样的方法，将 PART\_QM2 添加到集群。

##### 图 11. 选择将信息发送至的完整仓储库队列管理器 #####

![图 11. 选择将信息发送至的完整仓储库队列管理器][11.]

最后需要在两个部分仓储库队列管理器上定义各自的集群队列 TEST\_QUEUE。如图 12 所示，这里将缺省绑定类型设为不固定。

##### 图 12.在两个部分仓储库队列管理器上定义集群队列 #####

![Figure xxx. Requires a heading][]

创建完两个集群队列后，可以在两个完整仓储库队列管理器 FULL\_QM1 和 FULL\_QM2 上看到两个集群队列 TEST\_QUEUE。如图 13 所示。

##### 图 13. 创建成功的两个集群队列 #####

![图 13. 创建成功的两个集群队列][13.]

在之前显示建立的集群拓扑图中提到，本文只显示建立 PART\_QM1 到完整仓储库队列管理器 FULL\_QM1 的发送通道。而 PART\_QM1 到 FULL\_QM2 的发送通道是集群自动建立的。因此，在 PART\_QM1 的集群发送通道中可以看到两个发送通道，如图 14 所示，其中 TO.FULL\_QM1 发送通道是通过 MQ explorer 显式创建的，定义类型为自动显示集群发送方。而 TO.FULL\_QM2 发送通道是系统自动创建的，定义类型为自动集群发送方。

##### 图 14. 队列管理器 PART\_QM1 的集群发送通道 #####

![图 14. 队列管理器 PART\_QM1 的集群发送通道][14. _ PART_QM1]

## 使用示例应用程序演示 MQ 集群的负载平衡效果 ##

创建完一个简单的集群后，通过配置可以实现群集的负载均衡效果。本文在集群中定义了集群队列 TEST\_QUEUE 的两个同名队列实例，每个队列实例在不同的队列管理器上。当应用程序把消息发送到该集群队列时，MQ 使用负载平衡算法决定消息实际发送哪个队列管理器。

示例程序首先连接到一个完整仓储库队列管理器 FULL\_QM1，将绑定的类型设定为 MQOO\_BIND\_AS\_Q\_DEF，然后将五个消息放入集群队列 TEST\_QUEUE 中，如清单 8 所示。绑定类型设定为 MQOO\_BIND\_AS\_Q\_DEF 是把连接到队列的绑定类型指定为队列缺省的绑定类型，本例中为不固定，是在创建集群队列时，通过设置缺省绑定类型指定的，如图 12 所示。

##### 清单 8. 将消息放入集群队列的示例程序 #####

<table style="width:940px;font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px 0px 30px;padding:0px;vertical-align:baseline;background:none;border:0px;float:none;height:auto;"> 
 <tbody style="margin:0px;padding:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;"> 
  <tr style="margin:0px;padding:0px;vertical-align:baseline;background:none;border-top:0px;float:none;height:auto;width:auto;"> 
   <td style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;vertical-align:baseline;background:none;border-width:0px;float:none;height:auto;width:auto;color:rgb(112,112,112);"> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      1 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      2 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      3 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      4 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      5 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      6 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      7 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      8 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      9 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      10 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      11 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      12 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      13 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      14 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      15 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      16 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      17 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      18 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      19 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      20 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      21 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      22 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      23 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      24 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      25 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      26 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      27 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      28 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      29 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      30 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      31 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      32 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      33 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      34 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      35 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      36 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      37 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      38 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      39 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      40 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      41 
    </div></td> 
   <td style="width:899px;font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;vertical-align:baseline;background:none;border-width:0px;float:none;height:auto;"> 
    <div style="margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;"> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">public class ClusterPut { </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;">
       &nbsp; 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">private static final String HOSTNAME = "127.0.0.1"; </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">private static final int PORT = 5000; </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">private static final String CHANNEL = "SYSTEM.DEF.SVRCONN"; </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">private static final int CCSID = 1208; </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">//we can also specify FULL_QM2 as queue manager </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">private static final String QM_NAME = "FULL_QM1"; </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">private static final String Q_NAME = "TEST_QUEUE"; </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;">
       &nbsp; 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">public static void main(String[] args) throws Exception { </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">// Set up WebSphere MQ environment </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">MQEnvironment.hostname = HOSTNAME; </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">MQEnvironment.port = PORT; </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">MQEnvironment.channel = CHANNEL; </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">MQEnvironment.CCSID = CCSID; </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;">
       &nbsp; 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">// Create a connection to the QueueManager </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">MQQueueManager qMgr = new MQQueueManager(QM_NAME); </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">// Specify the queue that we wish to open and the open options. </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">//MQOO_BIND_AS_Q_DEF option is specified here, so bind type is determined by </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">//default queue bind type </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">// We can also specify MQOO_BIND_ON_OPEN or MQOO_BIND_NOT_FIXED to cover </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">//default queue bind type </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">MQQueue queue = qMgr.accessQueue(Q_NAME, MQConstants.MQOO_BIND_AS_Q_DEF </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">+ MQConstants.MQOO_OUTPUT); </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">// Define a simple WebSphere MQ Message and write some text in UTF8 format </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">MQMessage msg = new MQMessage(); </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">msg.writeUTF("Hello World!"); </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">// Put five messages to the cluster queue with default put message options </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">queue.put(msg, new MQPutMessageOptions()); </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">queue.put(msg, new MQPutMessageOptions()); </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">queue.put(msg, new MQPutMessageOptions()); </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">queue.put(msg, new MQPutMessageOptions()); </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">queue.put(msg, new MQPutMessageOptions()); </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;">
       &nbsp; 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">// Close the queue and disconnect from the QueueManager </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">queue.close(); </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">qMgr.disconnect(); </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;">&nbsp;&nbsp;&nbsp;</code> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">} </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">}</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

指定集群队列的缺省绑定类型为不固定，程序第一次运行后，五条消息分别放入部分仓储库队列管理器 PART\_QM1 和 PART\_QM2 的 TEST\_QUEUE 队列中。如果不指定队列等级和优先级，程序运行后，在 PART\_QM1 的 TEST\_QUEUE 队列中有三条消息，在 PART\_QM2 的 TEST\_QUEUE 队列中有两条消息。

当集群队列的缺省绑定类型为打开时，如图 15 所示，程序第一次运行后，五条消息都放入 PART\_QM1 的 TEST\_QUEUE 队列中。程序第二次运行后，五条消息都放入 PART\_QM2 的 TEST\_QUEUE 队列中。指定为打开时，相当于在程序打开 TEST\_QUEUE 集群队列时，就决定要使用哪一个部分仓储库队列管理器上的队列，之后，在程序断开与队列管理器的连接前，所有的消息都放到那个队列里。

##### 图 15. 队列的缺省绑定类型 #####

![图 15. 队列的缺省绑定类型][15.]

如果挂起 PART\_QM1，则无论绑定类型指定为哪个选项，所有的消息都将发送到 PART\_QM2 上的集群队列里。

accessQueue 函数还有另外两个选项 MQOO\_BIND\_NOT\_FIXED 和 MQOO\_BIND\_ON\_OPEN，缺省值为 MQOO\_BIND\_ON\_OPEN。如果指定为 MQOO\_BIND\_ON\_OPEN，消息只发送给某一队列实例，相当于之前把集群队列的缺省绑定类型设定为打开时。在程序中指定绑定的类型为 MQOO\_BIND\_NOT\_FIXED 或者 MQOO\_BIND\_ON\_OPEN 会覆盖集群队列的缺省绑定类型。

## 使用集群队列时需要注意的几点 ##

如果对消息的逻辑处理有要求，或者对消息的处理顺序有要求，这时需要使用 MQOO\_BIND\_ON\_OPEN 选项。例如，程序 A 向某个集群队列发送两条相互关联的消息，一条消息包含元数据，另一条消息包含实际数据内容，它们之间通过 groupId 相互联系。并且该集群队列在集群的两个队列管理器上各有一个同名集群队列实例。现在程序 B 需要从集群队列中取出相互关联的两条消息进行处理，如果这两条消息分别被发送到了两个不同的集群队列实例中，则程序 B 打开一个集群队列实例后，无法通过其中一条消息的 groupId，在同一个集群队列实例中找到另一条消息。要解决这个问题，可以将相互关联的消息发送到同一个集群队列实例上。在程序 A 将消息放入集群队列时，需要指定 MQOO\_BIND\_ON\_OPEN 选项。

集群只在消息进入时实现负载平衡，一旦消息进入某个队列管理器上的集群队列，它就只能由该队列管理器处理。如果在消息被处理完之前，该队列管理器被挂起或者发生故障，已经进入该集群队列的消息将不能被处理。即其他队列管理器无法处理该队列管理器上同名的集群队列实例。这一点和 z/OS 的共享队列不同。在 z/OS 平台上，如果使用共享队列，多个队列管理器使用的是同一个队列实例，即使某个队列管理器不工作，其他的队列管理器可以处理该共享队列上的消息。

## 结束语 ##

本文主要介绍了 Websphere MQ 集群的基本概念。通过命令和 MQ explorer 演示如何创建一个简单的 MQ 集群，并通过把消息放入集群队列的具体实例，实现负载平衡的效果。最后，对如何使用集群队列提出了一些建议。通过本文，读者可以对 MQ 集群有一个深入的了解。

原文地址：

https://www.ibm.com/developerworks/cn/websphere/library/techarticles/1202\_gaoly\_mq/1202\_gaoly\_mq.html

[1. _ NEW_CLUSTER]: /images/20220527/c2732a5f300142efaae03b7c4373e792.png
[2. _ NEW_CLUSTER]: /images/20220527/33827dd761c84726a39634c315566852.png
[3.]: /images/20220527/1a752425f066467f894bb67ccb7be1e0.png
[4.]: /images/20220527/c9503be0140f4b3e912624d42561c9f5.png
[5.]: /images/20220527/f993a78d60954c0495dcfe1f3f6d3ca6.png
[6.]: /images/20220527/559fc5c150004f1aa32d38c1be5ef533.png
[7.]: /images/20220527/2b57de8a9621470b94a03d0855d4ae84.png
[8.]: /images/20220527/901924d92d864f0b89e240a38455823b.png
[9.]: /images/20220527/cd01ca2ba94346fea2c7a1fcc4e31d32.png
[10.]: /images/20220527/4c2b5b3475824042aca595f60eea7fe0.png
[11.]: /images/20220527/3d2b318a39ac44f79ce3c760992ae749.png
[Figure xxx. Requires a heading]: /images/20220527/2cb536e73c0e4f7b87230db027feb669.png
[13.]: /images/20220527/faa560e7f773428e97e08de619a788a8.png
[14. _ PART_QM1]: /images/20220527/d043b72349c849cf9fb0bc49d8d20cd8.png
[15.]: /images/20220527/f814633b2bd74186a1960e3520f14bc9.png