IBM Support

WebSphere MQ Clustering - Cluster hints and tips

Technote (FAQ)


This is a compilation of the most common problems and questions regarding WebSphere MQ Clustering and it is intended for new MQ Cluster users.


1. You are new to WebSphere MQ Clustering

2. You have questions regarding WebSphere MQ Clustering

3. You are experiencing a WebSphere MQ Cluster problem


This article is intended for new MQ Cluster users and contains the following sections:

Clustering hints and tips
Workload balancing - round robin processing
Collecting documentation
Learning more about this problem / component

Clustering hints and tips

  • Review the cluster manual. This book describes how to create and use clusters. It explains the concepts, terminology, and benefits of clustering. It shows a number of examples that you can perform to set up and maintain clusters of queue managers.
  • Stay current on MQ maintenance.
  • Remember to include the cluster parameter on all of the cluster object definitions (queues, channels, queue manager, and so on).
  • Verify that your cluster channels connecting to the repository queue manager go to running status when the queue manager starts. Access to the repository queue manager is the key to clustering.
  • Getting messages from remote cluster queues is not supported within the clustering component.

Workload balancing - round robin processing

An MQ cluster can have more than one definition for the same queue, and can therefore benefit from increased availability and workload balancing in your network. If you are going to use round robin processing to several instances of the same queue on different queue managers, then consider the following:
  • Your cluster queue should specify the parameter DEFBIND(*NOTFIXED) and the queue should be opened with the open option MQOO_BIND_NOT_FIXED.
  • If you have a local instance of the cluster queue, then all messages are routed to that local instance of the cluster queue. You can get around this by disabling the queue for puts in WebSphere MQ V6.0 by using the CLWLUSEQ object attribute.
  • You will get a fairly even distribution of messages to a given cluster queue only when all relevant cluster channels are running or inactive, and all instances of that cluster queue is enabled for puts.
  • When you have clusters containing more than one instance of the same queue, WebSphere MQ uses a workload management algorithm to determine the best queue manager to route a message to. The workload management algorithm selects the local queue manager whenever possible, unless in WebSphere MQ V6.0 you modify the CLWLUSEQ attribute. If the workload algorithm routes messages to remote queue manager, then it chooses destinations based on the state of the channel (including any priority you might have assigned to the channel) and the availability of the queue manager and queue. The algorithm uses a round-robin approach to finalize its choice between the suitable queue managers.

Collecting documentation

Documentation required by the support team.

  1. Go to the MustGather: Read First document.
  2. Select the operating system where the problem occurs.
  3. Select the clustering component

Learning more about this problem / component

How long does cluster information remain in the cluster repository?

YouTube MQonTV - WebSphere MQ Clustering

WebSphere MQ - Graphical Clustering Demo

MQSeries - Design considerations for large Clusters

WebSphere MQ Information Center

Related information

WebSphere MQ Library
WebSphere MQ Queue Manager Clusters Manual

Product Alias/Synonym


Document information

More support for: WebSphere MQ

Software version: 5.3, 6.0, 7.0

Operating system(s): AIX, HP NonStop, HP-UX, Linux, OpenVMS, Solaris, Tandem NSK, Windows, i5/OS, z/OS

Reference #: 1229905

Modified date: 09 February 2006