View DR RDQM status

We can view the status of all disaster recovery replicated data queue managers (DR RDQMs) on a node, or detailed information for a specified DR RDQM.


You use the rdqmstatus command to view the status of all DR RDQMs, or of individual RDQMs.

We must be a user in the mqm group to run the rdqmstatus command. We can run the command on either node of the DR RDQM pair.


Procedure

  • To view the status of all the DR RDQMs on a node, run the following command on that node:
    rdqmstatus
    The status of the DR RDQMs on the node is displayed, for example:
    Queue manager name:                     DRQM8
    Queue manager status:                   Ended immediately
    DR role:                                Secondary
    
    Queue manager name:                     DRQM7
    Queue manager status:                   Running
    DR role:                                Primary
    
  • To view the status of a particular RDQM, enter the following command:
    rdqmstatus -m  qmname
    The following table summarizes the information that is returned.

    Status Attribute Possible Values When Displayed
    Queue manager status state (as displayed by dspmq) Always displayed
    CPU n.nn% Only shown when RDQM on current node has primary role
    Memory nnnMB Only shown when RDQM on current node has primary role
    Queue manager file system nnnMB used,n.nGB allocated [n%] Only shown when RDQM on current node has primary role
    DR role Primary
    Secondary
    Unknown
    Always displayed
    DR Status Normal Normal operation
      Synchronization in progress Synchronization is in progress
      Partitioned The queue manager has been started on both nodes while the DR replication network is unavailable
      Remote system unavailable The connection to the other node has been lost
      Inconsistent A synchronization was in progress, but was interrupted
      Reverting to snapshot The user has chosen to revert to the snapshot that was taken when the queue manager entered the Inconsistent state.
      Remote system not configured The primary instance of the RDQM has been configured, but no secondary instance has been configured
      Failed negotiation One of the nodes has been set to synchronous replication and the other to asynchronous replication
    DR type Synchronous or asynchronous Always displayed
    DR port port_number (the TCP/IP port used to replicate the data for this queue manager) Always displayed
    DR local IP address The local IP address this queue manager is replicating from for DR Always displayed
    DR remote IP address The remote IP address this queue manager is replicating to for DR Always displayed
    DR out of sync data nKB Displayed when remote node unavailable or inconsistent
    DR synchronization progress n% Displayed when synchronization is in progress
    DR estimated time to completion YYYY-MM-DD HH:MM:SS Displayed when synchronization is in progress
    Snapshot reversion progress n% Displayed when DR status is Reverting to snapshot. The status counts down, so 0% shows completion


Example

Example of normal status on primary node:
Queue manager status:                   Running
CPU:                                    0.00
Memory:                                 123MB
Queue manager file system:              51MB used, 1.0GB allocated [5%]
DR role:                                Primary
DR status:                              Normal
DR type:                                Synchronous
DR port:                                3000
DR local IP address:                    192.168.20.1
DR remote IP address:                   192.168.20.2
Example of normal status on a secondary node:
Queue manager status:                   Ended immediately
DR role:                                Secondary
DR status:                              Normal
DR port:                                3000
DR local IP address:                    192.168.20.2
DR remote IP address:                   192.168.20.1

Example of status on primary node when synchronization is in progress:

Queue manager status:                   Running
CPU:                                    0.53
Memory:                                 124MB
Queue manager file system:              51MB used, 1.0GB allocated [5%]
DR role:                                Primary
DR status:                              Synchronization in progress
DR type:                                Synchronous
DR port:                                3000
DR local IP address:                    192.168.20.1
DR remote IP address:                   192.168.20.2
DR synchronization progress:            11.0%
DR estimated time to completion:        2017-09-06 14:55:05
Example of a primary node, showing it is partitioned:
Queue manager status:                   Running
CPU:                                    0.02
Memory:                                 124MB
Queue manager file system:              51MB used, 1.0GB allocated [5%]
DR role:                                Primary
DR status:                              Partitioned
DR type:                                Synchronous
DR port:                                3000
DR local IP address:                    192.168.20.1
DR remote IP address:                   192.168.20.2
Parent topic: RDQM disaster recovery


Related information