Suspending a queue manager from a uniform cluster

During normal operation of a uniform cluster, reconnectable client application instances might be automatically rebalanced at any time, to any queue manager in the cluster. To prevent applications from connecting to a particular queue manager for a period of time, for example, during maintenance operations or problem determination, use the SUSPEND QMGR command.

Issue the command SUSPEND QMGR CLUSTER(uniform cluster name)

In addition to the usual effects of suspending from an IBM MQ cluster, in a uniform cluster, the SUSPEND command also prevents reconnectable applications from being rebalanced to this queue manager.

Any such existing connections to the queue manager are immediately rebalanced to other available queue managers in the cluster when the command is issued. Note: If all queue managers in the uniform cluster are suspended, applications remain connected to one or more of the suspended queue managers. To avoid new connections being added to the queue manager being maintained, we should stop the server connection channel, or channels, used by your client applications, for example by issuing the following runmqsc command:
STOP CHANNEL(svrconn channel name)

This might not be possible if, for example, these channels are also used to connect administrative applications required during the maintenance window. For this reason, the suspended queue manager periodically checks for attached reconnectable applications

If any reconnectable applications are present, they are rebalanced to other available queue managers in the cluster. Maintenance can now be performed on the suspended queue manager.Note: Applications not considered movable are not affected by either the initial command or subsequent rescans, and remain connected to the suspended queue manager; see MOVCOUNT for more details. To resume a suspended queue manager:
  1. If required, start the server connection channel to resume accepting new application connections, by issuing the following command:
    START CHANNEL(svrconn channel name)
  2. Issue the following runmqsc command:
    RESUME QMGR CLUSTER(uniform cluster name)

The queue manager resumes communication with the rest of the uniform cluster and, if required to restore balance, reconnectable client application instances are redirected to this queue manager.

Parent topic: Configure a uniform cluster