Starting, stopping, and displaying the state of an HA RDQM

You use variants of standard IBM® MQ control commands to start, stop, and view the current state of a replicated data queue manager (RDQM).

About this task

You must run the commands that start, stop, and view the current state of a replicated data queue manager (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 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 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 
```
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 running elsewhere is displayed. For example, if dspmq is run on node RDQM7, the following information might be returned:
```
QMNAME(RDQM8)                          STATUS(Running elsewhere)
QMNAME(RDQM9)                          STATUS(Running elsewhere)
QMNAME(RDQM7)                          STATUS(Running)
```
If the primary node is not available, or if dspmq is run by a user who is not root or a member of the haclient group, then the Unavailable state is reported. For example:
```
QMNAME(RDQM8)              STATUS(Unavailable)
QMNAME(RDQM9)              STATUS(Unavailable)
QMNAME(RDQM7)              STATUS(Unavailable)
```
You can enter the command dspmq -o ha (or dspmq -o HA) to view a list of queue managers known to a node, and whether they are RDQMs or not, for example:
```
dspmq -o ha 

QMNAME(RDQM8)                                      HA(Replicated)
QMNAME(RDQM9)                                      HA(Replicated)
QMNAME(RDQM7)                                      HA(Replicated)
QMNAME(QM7)                                        HA()
```