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).


We 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.

We 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 we want to start.

    The RDQM is started, and Pacemaker starts managing the RDQM. We must specify the -ns option with strmqm if we 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 we 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)
    
    We 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()
    

Parent topic: RDQM high availability


Related information