IBM MQ cluster commands and attributes

There are MQSC and PCF cluster commands that you can use to refresh or reset a cluster, or to display, resume or suspend a cluster queue manager. In addition, the MQSC and PCF commands that define channels, queues, and queue managers have attributes that apply to clusters. Some of these attributes are used by the cluster workload management algorithm.

MQSC commands

The MQSC commands are shown as they would be entered by the system administrator at the command console. Remember that you do not have to issue the commands in this way. There are a number of other methods, depending on your platform; for example:
  • [IBM i]On IBM® MQ for IBM i, you run MQSC commands interactively from option 26 of WRKMQM. You can also use CL commands or you can store MQSC commands in a file and use the STRMQMMQSC CL command.
  • [z/OS]On z/OS® you can use the COMMAND function of the CSQUTIL utility, the operations and control panels, or the z/OS console.
  • On all other platforms, you can store the commands in a file and use runmqsc.

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

A list of cluster names that is 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 WebSphere® MQ for z/OS 6.0 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®, you 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, you can view cluster queues and inquire about the status of cluster-sender and cluster-receiver channels. IBM MQ Explorer includes two wizards, which you can use to guide you through the following tasks:
  • Create a cluster
  • Join an independent queue manager to a cluster

PCF equivalents of MQSC commands specifically to work with clusters

MQSC command Equivalent PCF command
DISPLAY CLUSQMGR MQCMD_INQUIRE_CLUSTER_Q_MGR
REFRESH CLUSTER MQCMD_REFRESH_CLUSTER
RESET CLUSTER MQCMD_RESET_CLUSTER
RESUME QMGR MQCMD_RESUME_Q_MGR_CLUSTER
SUSPEND QMGR MQCMD_SUSPEND_Q_MGR_CLUSTER