Adding a queue manager to a cluster

We can add a queue manager to a cluster as either a full repository or a partial repository.

About this task

This task shows how to add a queue manager to an existing cluster using the Create Cluster wizard in IBM MQ Explorer. We can use the wizard to add a queue manager, provided that the queue manager does not already belong to another cluster.

Although we can add any queue manager to an existing cluster, even if the queue manager already belongs to another cluster, we cannot use the Create Cluster wizard if the queue manager already belongs to another cluster. We must configure the cluster using MQSC commands.

Before we can add a queue manager to a cluster:

• Create the queue manager.
• The queue manager must have a running listener.
• We must know the connection details of the queue manager because the we are asked to enter these details in the wizard.

To add a queue manager to a cluster:

Procedure

1. In the Navigator view, right-click the cluster, then click Add queue manager to cluster The Create Cluster wizard opens.
2. Work through the pages in the wizard to enter the following information about the queue manager:
   1. Page 1: The name of the queue manager. The queue manager must already exist; click Add queue manager to MQ Explorer if the queue manager is not already known to IBM MQ Explorer.
   2. Page 2: Whether the queue manager will be a full repository or a partial repository for the cluster.
   3. Page 3: The connection name of the queue manager. The format of the connection name depends on the transport protocol that the queue manager uses. For example, if the queue manager uses TCP/IP, we can use the format computer_name(port_number) where computer_name is the name or IP address of the computer that hosts the queue manager, and port_number is the port number on which the queue manager listens for connections.
   4. Page 4: If the queue manager will be a partial repository, select one or more full repository queue managers to which the partial repository queue manager will send information about the cluster.
   5. Page 5: If the queue manager will be a partial repository, select the cluster-receiver channel that the full repository queue manager will use to receive information from the partial repository queue manager.
   6. Page 6: Using the list, specify a cluster-sender channel on each full repository queue manager that they will use to send cluster information to the new repository queue manager.

3. Click Finish to add the queue manager the cluster.

Results

The queue manager is added to the cluster as a full repository or a partial repository. The queue manager is displayed in the Full Repository folder or the Partial Repository folder for the cluster.

For more information, see Distributed queuing and clusters and Administration using MQSC commands.

Parent topic: Create and configure a queue manager cluster

Related concepts

• Queue manager clusters
• Cluster repositories

Related tasks

• Create a queue manager cluster