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

About this task

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

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

  Table 1. Status attributes

  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 hen 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