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 you 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 you 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. 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 you can use the z/OS console.
  • On all other platforms, you 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 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®, 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

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