Viewing the status of a high availability queue manager

You can view the status of a queue manager in a high availability (HA) group by using the status command on the command line, or by using the IBM® MQ Console.

About this task

The status command returns information about the operational status of a specified queue manager in the HA group. The status can include the following information:
  • The high availability role of the queue manager (reported as Primary or Secondary).
  • The current high availability status:
    Normal
    The appliances in the high availability configuration are operating normally.
    This appliance in standby mode
    This status means that the appliance has been suspended (by using the sethagrp -s command).
    Secondary appliance in standby mode
    This status means that the other appliance in the HA pair has been suspended (by using the sethagrp -s command).
    Both appliances in standby mode
    This status means that both appliances in the HA pair have been suspended (by using the sethagrp -s command).
    Secondary appliance unavailable
    This status means that the connections to the other appliance in the HA pair have been lost.
    Remote appliance(s) unavailable
    This status means that the replication connection to the other appliance has been lost.
    Partitioned
    Queue manager data on the appliances is out of step, and cannot be automatically resolved.
    Synchronization in progress
    This status is displayed when the primary queue manager is replicating data to the secondary queue manager.
    Inactive
    The queue manager is inactive on both appliances in the HA pair.
    Inconsistent
    The status is displayed on a secondary appliance during the initial synchronization of a queue manager if connection has been lost and synchronization was interrupted. The secondary appliance cannot provide high availability functionality until the initial synchronization has completed.
  • [MQ 10 2026]The encryption status of the HA replication link. The HA TLS encryption: field displays one of the following values:
    Not configured
    The replication link has not been configured to use encryption.
    Yes
    The replication link is configured for TLS encryption, and TLS encryption is currently active.
    No
    The replication link is configured for TLS encryption, and TLS is not currently active.
  • [MQ 10 2026]The encryption status of the DR replication link. The DR TLS encryption: field displays one of the following values:
    Not configured
    The replication link has not been configured to use encryption.
    Yes
    The replication link is configured for TLS encryption, and TLS encryption is currently active.
    No
    The replication link is configured for TLS encryption, and TLS is not currently active.
  • [MQ 10 2026]The configured name of the remote HA group for an HA/DR queue manager that has encryption on the DR replication link is displayed in the DR Remote HA group name: field.
  • The preferred appliance setting for the queue manager, set to This Appliance or Other Appliance.
  • The percentage complete of a synchronization operation. This information is shown only when the status is Synchronization in progress.
  • The estimated time at which a synchronization will complete. This information is shown only when the status is Synchronization in progress.
  • The amount of out-of-sync data that exists on this instance of the queue manager. This is the amount of data written to this instance of the queue manager since it last synchronized. This information is shown when the status is Partitioned or Inconsistent.
  • The time and date that the data was last in sync. This is displayed whenever data is out of sync.
If an HA configuration has a failed resource action, you can view details of the action by specifying the -a option. See Failed resource actions for more information about failed resource actions. The following information is provided:
Failed resource action
The type of resource action that has failed.
Resource type
The type of resource the action was attempted on.
Failure location
Whether the failure occurred on the appliance on which you are running the status command or on the other appliance in the HA group.
Failure time
The time that the failure occurred.
Failure reason
The cause of the failure.
Blocked location
Whether the failure is preventing the queue manager from running on this appliance, or the other appliance in the HA group, or both.

You can also use the dspmq command to check whether a queue manager is configured for high availability and if a floating IP address has been configured for it. See dspmq (display queue managers). You can also use the IBM MQ REST API to retrieve dspmq status information. See /admin/qmgr in the IBM MQ documentation.

Procedure

  • To view the HA status of a queue manager by using the command line interface:
    1. Enter the IBM MQ administration mode by entering the following command:

      mqcli

    2. View the status of an HA queue manager by entering the following command from one of the appliances:

      status QMgrName

      Where:
      QMgrName
      Specifies the name of the HA queue manager that you want to view the status of.
    3. Exit the IBM MQ administration mode by entering the following command:

      exit

  • To view the HA status of a queue manager, including failed resource actions, by using the command line interface:
    1. Enter the IBM MQ administration mode by entering the following command:

      mqcli

    2. View the status of an HA queue manager, including failed resource actions, by entering the following command from one of the appliances:

      status -a QMgrName

      Where:
      QMgrName
      Specifies the name of the HA queue manager that you want to view the status of.
    3. Exit the IBM MQ administration mode by entering the following command:

      exit

  • To view the HA status of a queue manager by using the IBM MQ Console:
    1. Open the console and go to the Manage view.
    2. Click the High availability tab. The status of HA queue manager is shown in the HA status column.

Example

The following output shows an example of using the status command to view the status of HA queue manager MyHAQM1 together with details of failed resource actions:
mqa(mqcli)# status -a MyHAQM1
QM(MyHAQM1)                              Status(Running)
CPU:                                     1.32%
Memory:                                  188MB
Queue manager file system:               0.2GB total, 56MB used [45%]
HA role:                                 Primary
HA status:                               Normal
HA control:                              Enabled
HA preferred location:                   This appliance
HA blocked location:                     Other appliance
DR role:                                 Primary
DR replication type:                     Asynchronous
DR status:                               Normal

Failed resource action:                  Promote
Resource type:                           HA replication
Failure location:                        Other appliance
Failure time:                            2022-01-01 14:58:31
Failure reason:                          Peer node already/still Primary
Blocked location:                        None

Failed resource action:                  Monitor
Resource type:                           DR floating IP
Failure location:                        Other appliance
Failure time:                            2022-01-01 15:02:03
Failure reason:                          Not installed
Blocked location:                        Other appliance
This status shows that the queue manager is currently blocked from running on the other appliance in the HA pair because of misconfiguration. You must correct the problem, and then run the cleanha command to clear the failed resource actions to restore operation of the HA group.