Removing a queue manager from a cluster

 

---

Scenario

• The INVENTORY cluster has been set up as described in Adding a new queue manager that hosts a queue and modified as described in Removing a cluster queue from a queue manager.

• For business reasons you no longer want to carry out any inventory work at Paris and so you want to remove the PARIS queue manager from the cluster.

 

Procecure

Perform the following tasks at the PARIS queue manager.

 

1. Suspend queue manager PARIS

Issue the SUSPEND QMGR command to suspend availability of the queue manager to the INVENTORY cluster:

SUSPEND QMGR CLUSTER(INVENTORY)

When you issue this command, other queue managers are advised that they should refrain from sending messages to PARIS.

 

2. Remove the CLUSRCVR channel definition

Remove the CLUSRCVR definition from the cluster:

ALTER CHANNEL(TO.PARIS) CHLTYPE(CLUSRCVR) CLUSTER(' ')

This command causes the full repository queue managers to remove all information about that channel from their full repositories, so that queue managers will no longer try to send messages to it.

At this point messages should have stopped arriving in the PARIS queue manager.

 

3. Stop the CLUSRCVR channel at PARIS

Issue the STOP CHANNEL command to stop the cluster-receiver channel:

STOP CHANNEL(TO.PARIS)

Once the channel is stopped, no more messages can be sent to PARIS.

Later, to tidy up, you will probably want to delete the channel:

DELETE CHANNEL(TO.PARIS)

 

4. Delete the CLUSSDR channel definition

The CLUSSDR channel definition points to the full repository at queue manager AMSTERDAM. Stop this channel as follows:

STOP CHANNEL(TO.AMSTERDAM)

and then delete it:

DELETE CHANNEL(TO.AMSTERDAM)

 

The cluster achieved by task 5

The queue manager PARIS is no longer part of the cluster. However, it can still function as an independent queue manager.

This modification to the cluster was accomplished without you having to make any alterations to the queue managers AMSTERDAM, LONDON, and PARIS.

Note:

If your queue manager is a full repository queue manager, before you can remove it from a cluster perform the additional step of altering the queue manager definition to set the REPOS and REPOSNL attributes to blank. This sends a notification to other queue managers advising them that they must stop sending cluster information to this queue manager.