status

Purpose

You can use the status command to get information about the disk usage, CPU usage, and memory usage for the appliance or for a specific queue manager.

This command must be run from the IBM® MQ administration mode. If the system is in the IBM MQ administration mode the prompt includes mqcli#. To enter the IBM MQ administration mode, enter mqcli on the command line. To exit the IBM MQ administration mode, enter exit on the command line.

The status command reports whether the file system of a queue manager is encrypted. It also reports whether there is any problem with the encryption passphrase. The following problems might be reported:

encrypted, not available, passphrase not stored: If the passphrase for a file system is not stored in the vault then the file system cannot be mounted, and the queue manager status is reported as not available.
encrypted, not available, passphrase not valid: If the passphrase for a file system stored in the vault is not valid then the file system cannot be mounted, and the queue manager status is reported as not available.
encrypted, passphrase not stored: If the passphrase is cleared from the vault for a file system that is already mounted, the filesystem continues to be available until it is unmounted. The passphrase must be stored in the vault once again before the file system can be mounted again.

If the queue manager is running in a high availability configuration, the following information is also reported:

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

If the queue manager is running in a disaster recovery configuration, the following information is also reported:

The disaster recovery role of the queue manager (reported as Primary or Secondary).
Whether asynchronous or synchronous replication is used.
The current disaster recovery status:

Normal

The appliances in the disaster recovery configuration are operating normally.

Synchronization in progress

This status can mean that initial replication is completing, or there has been a failure of the disaster recovery replication network and the queue manager has switched into synchronization mode to catch up as quickly as possible.

Partitioned

Queue manager data on the appliances is out of step, and cannot be automatically resolved. The makedrprimary and makedrsecondary commands must be used to resolve the situation. When this status is displayed on one of the appliances in a disaster recovery pair, the other appliance might display the remote appliance unavailable status, because the connection was lost before it detected the partitioned status.

Paused

In a DR/HA configuration, this status occurs if the DR replication link detects the need for a catch-up synchronization but neither DR node is currently primary (due to a failure having just occurred). This is most likely caused by demoting the primary at the same moment as the need for a synchronization is detected. This situation can be resolved by re-promoting the recently demoted appliance and waiting for the synchronization to complete.

Remote appliance(s) unavailable

The status means that the connection to the other appliance in the disaster recovery configuration has been lost.

Inactive

The queue manager is in the secondary role on both appliances.

Inconsistent

This status is shown only when the queue manager is in the secondary role and an in-progress synchronization has been interrupted. If you use the makedrprimary command on a queue manager that is in this state, the queue manager reverts to the snapshot of its data that was taken before it entered the inconsistent state.

Reverting to snapshot

This status is shown when the queue manager is in the secondary role, and the makedrprimary command is issued when the queue manager is in the Inconsistent state. The queue manager is reverted to the current snapshot of its data such that it can run.

Remote appliance(s) not configured

This status is shown when the crtdrprimary command has been run, to specify that a queue manager has the primary role, but no crtdrsecondary command has been run on the other appliance in the disaster recovery pair.

Failed negotiation

This status is shown if the replication type is not consistent for the DR primary and the DR secondary (that is, one is configured to use synchronous replication and the other is configured to use asynchronous replication).
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 only when the status is Partitioned, Inconsistent, or Remote appliance(s) unavailable.
The time and date that the data was last in sync. This is displayed whenever data is out of sync.
The percentage complete of a reversion to snapshot operation. This information is shown only when the status is Reverting to snapshot.

If the queue manager is part of both an HA and a DR configuration, then both HA and DR information is displayed, with the additional fields:

DR local IP address: The IP address of the recovery interface (usually eth20) of the local appliance.
DR remote configuration: Indicates if the remote configuration is an HA pair, set to either High availability group or Single appliance.
DR remote IP address list: If the remote configuration is an HA group, lists the two IP addresses used by the two appliances in the group.
DR current remote IP address: The IP address of the current recovery interface (usually eth20) of the remote appliance.

Syntax

Parameters

QMgrName: Specifies the name of the queue manager for which the status summary is returned.; If this parameter is omitted, a summary of all disk and memory usage on the appliance is returned.
-a: Optionally specify this parameter to include details of any failed resource actions.

Usage Notes

This command must be run from the IBM MQ administration mode. If the system is in the IBM MQ administration mode the prompt includes mqa(mqcli)#. To enter the IBM MQ administration mode, enter mqcli on the command line. To exit the IBM MQ administration mode, enter exit on the command line.
The information that is returned for the appliance includes the following information:
- The size and usage of the system memory
- The CPU usage of the system
- CPU average load (in 1, 5, and 15 minute averages)
- The size and usage of the internal disk
- The size and usage of the system volume
- The size and usage of the root file system, and its status
- The size and usage of the backup file system, and its status
- The size and usage of the diagnostics file system, and its status
- The size and usage of the errors file system, its status, and the number of FDCs
- The size and usage of the trace file system, and its status
The status for root, diagnostics, errors, and trace file systems includes whether it is encrypted, and if it is, whether the passphrase is either not stored or not valid. The status for these file systems also indicates if the file system does not exist (not allocated) or is not mounted (not available). The status for the backup file system indicates if the file system does not exist (not allocated) or is not mounted (not available).
The information that is returned for a queue manager includes the following information:
- The queue manager name
- The queue manager status
- The CPU usage of the queue manager
- The memory usage of the queue manager. If this is a disaster recovery queue manager, this figure does not include the additional memory required for the snapshot image. Note that creating a primary queue manager in a disaster recovery configuration fails if there is insufficient memory for both the queue manager data, and the snapshot of the queue manager data.
- The amount of the queue manager file system used by the queue manager
- Whether the file system is encrypted
The information that is returned for a high availability queue manager can also include the following information:
- The operational state of the HA group
- The replication status of the queue manager (if synchronization is in progress)
- The preferred appliance for the queue manager
- Whether a partitioned situation has been detected, and if it has, the amount of 'out-of-sync' data held
The information that is returned for a disaster recovery queue manager can also include the following information:
- The disaster recovery role (primary or secondary)
- Whether asynchronous or synchronous replication is used
- The disaster recovery status
- The percentage complete if synchronization is in progress
- The estimated time to completion if synchronization is in progress
- The amount of out-of-sync data if the disaster recovery system is partitioned
- The percentage complete if reversion to snapshot is in progress
- The number of logical writes not yet completed by the primary instance of a queue manager to the secondary instance.
- The number of logical bytes not yet written by the primary instance of a queue manager to the secondary instance.

Examples

The following command returns a report for the appliance:
```
status
```
The following command returns a report for a specific queue manager, QM1:
```
status QM1
```
The following command returns a report for a specific queue manager, QM1, and includes failed resource action information:
```
status QM1 -a
```