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.


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

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 DR/HA 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 DR/HA 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 -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)

Parent topic: RDQM disaster recovery and high availability


Related information