IBM MQ cluster commands

IBM MQ cluster commands

The IBM MQ Script commands runmqsc commands have special attributes and parameters that apply to clusters. There are other administrative interfaces we can use to manager clusters.
The MQSC commands are shown as they would be entered by the system administrator at the command console. Remember that we do not have to issue the commands in this way. There are a number of other methods, depending on your platform; for example:

On IBM MQ for IBM i, you run MQSC commands interactively from option 26 of WRKMQM. We can also use CL commands or we can store MQSC commands in a file and use the STRMQMMQSC CL command.
On z/OS® we can use the COMMAND function of the CSQUTIL utility, the operations and control panels or we can use the z/OS console.

On all other platforms, we can store the commands in a file and use runmqsc.

In a MQSC command, a cluster name, specified using the CLUSTER attribute, can be up to 48 characters long.

A list of cluster names, specified using the CLUSNL attribute, can contain up to 256 names. To create a cluster namelist, use the DEFINE NAMELIST command.

IBM MQ Explorer

The IBM MQ Explorer GUI can administer a cluster with repository queue managers on IBM MQ for z/OS Version 6 or later. You do not need to nominate an additional repository on a separate system. For earlier versions of IBM MQ for z/OS, the IBM MQ Explorer cannot administer a cluster with repository queue managers. You must therefore nominate an additional repository on a system that the IBM MQ Explorer can administer.

On IBM MQ for Windows and IBM MQ for Linux , we can also use IBM MQ Explorer to work with clusters. You can also use the stand-alone IBM MQ Explorer client.
Using the IBM MQ Explorer, we can view cluster queues and inquire about the status of cluster-sender and cluster-receiver channels. IBM MQ Explorer includes two wizards, which we can use to guide you through the following tasks:

Create a cluster
Join an independent queue manager to a cluster

Programmable command formats (PCF)

Table 1. PCF equivalents of MQSC commands specifically to work with clusters

runmqsc command PCF equivalent

DISPLAY CLUSQMGR MQCMD_INQUIRE_CLUSTER_Q_MGR

SUSPEND QMGR MQCMD_SUSPEND_Q_MGR_CLUSTER

RESUME QMGR MQCMD_RESUME_Q_MGR_CLUSTER

REFRESH CLUSTER MQCMD_REFRESH_CLUSTER

RESET CLUSTER MQCMD_RESET_CLUSTER

Queue manager definition commands
Cluster attributes that can be specified on queue manager definition commands.
Channel definition commands
Cluster attributes that can be specified on channel definition commands.
Queue definition commands
Cluster attributes that can be specified on the queue definition commands.
DISPLAY CLUSQMGR
Use the DISPLAY CLUSQMGR command to display cluster information about queue managers in a cluster.
SUSPEND QMGR, RESUME QMGR and clusters
Use the SUSPEND QMGR and RESUME QMGR command to temporarily reduce the inbound cluster activity to this queue manager, for example, before you perform maintenance on this queue manager, and then reinstate it.
REFRESH CLUSTER
Issue the REFRESH CLUSTER command from a queue manager to discard all locally held information about a cluster. You are unlikely to need to use this command, except in exceptional circumstances.
RESET CLUSTER
Use the RESET CLUSTER command to forcibly remove a queue manager from a cluster in exceptional circumstances.
Workload balancing in clusters
If a cluster contains more than one instance of the same queue, IBM MQ selects a queue manager to route a message to. It uses the cluster workload management algorithm, and a number of cluster workload-specific attributes, to determine the best queue manager to use.
Asynchronous behavior of CLUSTER commands on z/OS
The command issuer of a cluster command on z/OS receives confirmation a command has been sent, but not that it has completed successfully.
Parent topic: Configuration reference

Related information

Clustering: Using REFRESH CLUSTER best practices

runmqsc command	PCF equivalent
DISPLAY CLUSQMGR	MQCMD_INQUIRE_CLUSTER_Q_MGR
SUSPEND QMGR	MQCMD_SUSPEND_Q_MGR_CLUSTER
RESUME QMGR	MQCMD_RESUME_Q_MGR_CLUSTER
REFRESH CLUSTER	MQCMD_REFRESH_CLUSTER
RESET CLUSTER	MQCMD_RESET_CLUSTER