Starting, stopping, and displaying the state of a DR/HA RDQM

You use variants of standard IBM® MQ control commands to start, stop, and view the current state of a DR/HA RDQM.

About this task

You must run the commands that start, stop, and view the current state of a DR/HA RDQM as a user that belongs to both the mqm and haclient groups.

You must run the commands to start and stop a queue manager on the primary node for that queue manager.

Procedure

To start an RDQM, enter the following command on the RDQM's primary node:
```
strmqm qmname
```
where qmname is the name of the DR/HA RDQM that you want to start.
The RDQM is started, and Pacemaker starts managing the RDQM. You must specify the -ns option with strmqm if you want to specify any other strmqm options.
To stop an RDQM, enter the following command on the DR/HA RDQM's primary node:
```
endmqm qmname
```
where qmname is the name of the RDQM that you want to stop.
Pacemaker ceases to manage the RDQM, and then the RDQM is ended. All other endmqm parameters can be used when stopping an RDQM.
To view the state of an RDQM, enter the following command:
```
dspmq -m QMname
```
The state information that is output depends on whether you run the command on the RDQM's primary or secondary node. If run on the primary node then one of the normal status messages returned by dspmq is displayed. If you run the command on a secondary node then the status Ended immediately is displayed. For example, if dspmq is run on node RDQM7, the following information might be returned:
```
QMNAME(DRQM8)                         STATUS(Ended immediately)
QMNAME(DRQM7)                         STATUS(Running)
```
You can use arguments with dspmq to establish whether an RDQM is configured for disaster recovery, and whether it is currently the primary or the secondary instance:
```
dspmq -m QMname -o (dr | DR)
```
One of the following responses is displayed:

DRROLE()

Indicates that the queue manager is not configured for disaster recovery.

DRROLE(Primary)

Indicates that the queue manager is configured as the DR primary.

DRROLE(Secondary)

Indicates that the queue manager is configured as the DR secondary.
Use the dspmq -o all command to view the disaster recovery and high availability information for DR/HA RDQMs. For example, if you run dspmq -o all on the node where the DR/HA RDQM is running, you see the following state information:
```
QMNAME(TESTQM1)                                           STATUS(Running) HA(Replicated) DRROLE(Primary)
```