[UNIX, Linux, Windows, IBM i]

DISPLAY QMSTATUS (display queue manager status) on Multiplatforms

Use the MQSC command DISPLAY QMSTATUS to display status information associated with this queue manager.

Using MQSC commands

For information on how you use MQSC commands, see Administering IBM® MQ using MQSC commands.

Synonym: DIS QMSTATUS

DISPLAY QMSTATUS

Read syntax diagramSkip visual syntax diagram DISPLAY QMSTATUS TYPE(QMGR)ALLLOGRequested attributesLog attributesTYPE(NATIVEHA)ALLNative HA attributes
Requested attributes
Read syntax diagramSkip visual syntax diagram,AUTOCLUSCHINITCMDSERVCONNSDATFSSZDATFSUSEDATPATHHOSTNAMEINSTANCEINSTDESCINSTNAMEINSTPATHLDAPCONNQMNAMEQMFSENCQMFSSZQMFSUSEQUORUMSTANDBYSTARTDASTARTTISTATUSUNICLUS
Log attributes
Read syntax diagramSkip visual syntax diagram,ARCHLOGARCHSZCURRLOGLOGEXTSZLOGFSSZLOGFSUSELOGINUSELOGPATHLOGPRIMLOGSECLOGSTRDALOGSTRLLOGSTRTILOGTYPELOGUTILMEDIALOGMEDIASZRECLOGRECSZREUSESZ
Native HA attributes
Read syntax diagramSkip visual syntax diagram,BACKLOG CONNACTV HAINITDA HAINITL HAINITTI INSTANCEINSYNC REPLADDR ROLE

Parameter descriptions for DISPLAY QMSTATUS

ALL
Specify this parameter to display all the parameters. If this parameter is specified, any parameters that are requested specifically have no effect; all parameters are still displayed.

This parameter is the default if you do not request any specific parameters.

LOG
Specify this parameter to display all the LOG parameters. If this parameter is specified, any LOG parameters that are requested specifically have no effect; all parameters are still displayed.

[MQ 9.3.2 Feb 2023]For parameters for DISPLAY QMSTATUS TYPE(NATIVEHA), see Attributes for TYPE (NATIVEHA).

Requested parameters

Specify one or more parameters that define the data to be displayed. The parameters can be specified in any order, but do not specify the same parameter more than once.

ARCHLOG
Name of the oldest log extent for which the queue manager is waiting for archive notification. This parameter is:
  • Available only on queue managers using archive log management.
  • Blank, if the queue manager is not using archive log management, or if the queue manager has no extents waiting for notification.

[IBM i]This parameter is not valid on IBM i.

ARCHSZ

The amount of space occupied, in megabytes, by log extents no longer required for restart or media recovery, but waiting to be archived.

Note that this value impacts the total space used by the queue manager for log extents.

This parameter is available only on queue managers using archive log management. If the queue manager is not using archive log management, this parameter is zero.

[IBM i]This parameter is not valid on IBM i.

[MQ 9.3.2 Feb 2023]AUTOCLUS
Whether the queue manager is a member of an automatic cluster. Is one of the following:
NONE
Does not belong to an automatic cluster.
UNIFORM
Is part of a uniform cluster.
See Using automatic cluster configuration.

CHINIT
The status of the channel initiator reading SYSTEM.CHANNEL.INITQ. It is one of the following:
STOPPED
The channel initiator is not running.
STARTING
The channel initiator is in the process of initializing and is not yet operational.
RUNNING
The channel initiator is fully initialized and is running.
STOPPING
The channel initiator is stopping.

CMDSERV
The status of the command server. It is one of the following:
STOPPED
The command server is not running.
STARTING
The command server is in the process of initializing and is not yet operational.
RUNNING
The command server is fully initialized and is running.
STOPPING
The command server is stopping.

CONNS
The current number of connections to the queue manager.

CURRLOG
The name of the log extent being written to at the time that the DISPLAY QMSTATUS command is processed. If the queue manager is using circular logging, and this parameter is explicitly requested, a blank string is displayed.

[MQ 9.3.2 Feb 2023]DATFSSZ
The size of the dedicated queue manager data file system in MB, rounded up. If the queue manager data and recovery log are on the same file system, the value is SHARED (see QMFSSZ).

[MQ 9.3.2 Feb 2023]DATFSUSE
The percentage of the dedicated queue manager data file system that is full, rounded up to the nearest percent. If the queue manager data and recovery log are on the same file system, the value is SHARED (see QMFSUSE).

[MQ 9.3.2 Feb 2023]DATPATH
The path of the queue manager data directory.

[MQ 9.3.2 Feb 2023]HOSTNAME
The name of the host that the queue manager is running on from the perspective of IBM MQ. Usually, this is the value reported by the O/S but it can be overridden by the MQS_IPC_HOST environment variable.

[MQ 9.3.2 Feb 2023]INSTANCE
The name of the local Native HA instance when the queue manager is part of a Native HA group. It is blank otherwise.

INSTDESC
Description of the installation associated with the queue manager.

INSTNAME
Name of the installation associated with the queue manager.

INSTPATH
Path of the installation associated with the queue manager.

LDAPCONN
The status of the connection to the LDAP server. It is one of the following:
CONNECTED
The queue manager currently has a connection to the LDAP server.
ERROR
The queue manager attempted to make a connection to the LDAP server and failed.
INACTIVE
The queue manager is not configured to use an LDAP server or has not yet made a connection to the LDAP server.
Note: The LDAPCONN status within DISPLAY QMSTATUS is a single status for the whole queue manager, reflecting only the most recent actions performed with the LDAP server. There are multiple connections to the LDAP server, one per queue manager agent process. LDAPCONN reflects the status from the most recent LDAP connection across the agents of the whole queue manager. If the error is temporary, and quickly clears, then the ERROR status will be short-lived. Always look in the queue manager error logs to see more details of any LDAP connectivity failures.
[MQ 9.3.2 Feb 2023]LOGEXTSZ
The size of each log file (or the threshold of the currently attached journal receiver on IBM i) in KB.

[MQ 9.3.2 Feb 2023]LOGFSSZ
The size of the dedicated recovery log file system in MB, rounded up. If the queue manager data and recovery log are on the same file system, the value is SHARED (see QMFSSZ).

[MQ 9.3.2 Feb 2023]LOGFSUSE
The percentage of the dedicated recovery log file system that is full, rounded up to the nearest percent. If the queue manager data and recovery log are on the same file system, the value is SHARED (see QMFSUSE).

LOGINUSE
The percentage of the primary log space in use for restart recovery at this point in time.

A value of 100 or greater indicates the queue manager might have allocated, and be using, secondary log files, probably due to long-lived transactions at this point in time.

[IBM i]This parameter is not valid on IBM i.

LOGPATH
Identifies the directory where log files are created by the queue manager.

[MQ 9.3.2 Feb 2023]LOGPRIM
The number of primary log files.

[IBM i]This parameter is not valid on IBM i.

[MQ 9.3.2 Feb 2023]LOGSEC
The maximum number of secondary log files.

[IBM i]This parameter is not valid on IBM i.

[MQ 9.3.2 Feb 2023]LOGSTRDA
The date for the last log record recovered when the queue manager started.

[IBM i]This parameter is not valid on IBM i.

[MQ 9.3.2 Feb 2023]LOGSTRL
The log sequence number (LSN) for the last log record recovered when the queue manager started, in <nnnnn:nnnnn:nnnnn:nnnnn> format.

[IBM i]This parameter is not valid on IBM i.

[MQ 9.3.2 Feb 2023]LOGSTRTI
The time for the last log record recovered when the queue manager was started.

[IBM i]This parameter is not valid on IBM i.

[MQ 9.3.2 Feb 2023]LOGTYPE
The type of logging, is one of the following values:
CIRCULAR
Uses circular logging.
LINEAR
Uses linear logging.
REPLICATED
Uses replicated logging.

For information about logging types, see Types of logging.

LOGUTIL

A percentage estimate of how well the queue manager workload is contained within the primary log space.

If the value is consistently above 100 you might want to investigate whether there are long-lived transactions, or if the number of primary files is not sufficient for the workload.

If the utilization continues to rise, eventually requests for most further operations requiring log activity will be refused, together with an MQRC_RESOURCE_PROBLEM return code being returned to the application. Transactions might be backed out.

[IBM i]This parameter is not valid on IBM i.

MEDIALOG
The name of the oldest log extent required by the queue manager to perform media recovery. If the queue manager is using circular logging, and this parameter is explicitly requested, a blank string is displayed.

MEDIASZ

Size of the log data required for media recovery in megabytes.

This value shows how much log that must be read for media recovery and directly impacts the time taken for this operation.

This is zero for a circular logging queue manager. The size is typically reduced by taking more frequent media images of objects.

[IBM i]This parameter is not valid on IBM i.

[MQ 9.3.2 Feb 2023]QMFSENC
Indicates whether the queue manager file system is encrypted or not. Is set to one of the following values:
NO
The file system is not encrypted.
YES
The file system is encrypted.
UNKNOWN
The encryption status is not known.

[MQ Appliance]Returned on the IBM MQ Appliance only.

[MQ 9.3.2 Feb 2023]QMFSSZ
The total size of the queue manager data and recovery log file systems in MB, rounded up. If the queue manager data and recovery log are on the same file system, the value is the size of that file system.

[MQ 9.3.2 Feb 2023]QMFSUSE
The percentage of the queue manager data and recovery log file systems that are full, rounded up to the nearest percent. If the queue manager data and recovery log are on the same file system, the value will be the usage of that file system.

QMNAME
The name of the queue manager. This parameter is always returned.

[MQ 9.3.2 Feb 2023]QUORUM
Two numeric values separated by a forward slash (X/Y) if the queue manager is part of a Native HA group, or blank otherwise. The two values give the following information:
  • X is how many of the configured instances are in-sync with the active instance.
  • Y is the total number of configured instances of the queue manager.

RECLOG
The name of the oldest log extent required by the queue manager to perform restart recovery. If the queue manager is using circular logging, and this parameter is explicitly requested, a blank string is displayed.

RECSZ
Size of the log data required for restart recovery in megabytes.

This value shows how much log that must be read for restart recovery and directly impacts the time taken for this operation.

[IBM i]This parameter is not valid on IBM i.

REUSESZ
This attribute is valid only on automatic or archive log management queue managers.

The amount of space occupied, in megabytes, by log extents available to be reused.

This value impacts the total space used by the queue manager for log extents.

The size is automatically managed by the queue manager, but if necessary you can request reductions using the RESET QMGR TYPE(REDUCELOG) command.

[IBM i]This parameter is not valid on IBM i.

STANDBY
Whether a standby instance is permitted. It is one of the following:
NOPERMIT
Standby instances are not permitted.
PERMIT
Standby instances are permitted.

STARTDA
The date on which the queue manager was started (in the form yyyy-mm-dd).

STARTTI
The time at which the queue manager was started (in the form hh.mm.ss).

STATUS
The status of the queue manager. It is one of the following:
STARTING
The queue manager is in the process of initializing.
RUNNING
The queue manager is fully initialized and is running.
QUIESCING
The queue manager is quiescing.

[MQ 9.3.2 Feb 2023]UNICLUS
The name of the uniform cluster that the queue manager is a member of, or blank otherwise.

[MQ 9.3.2 Feb 2023]

Attributes for TYPE (NATIVEHA)

When you specify TYPE(NATVEHA) you can specify ALL to have all attributes returned, alternatively you can specify one or more of the following parameters:
BACKLOG (for REPLICA instances only)
How many KB of recovery log data the active instance has written that have not yet been acknowledged by the named instance. This is how ‘out of sync’ the named instance currently is. The value is rounded up to a 1 KB boundary. Set to UNKNOWN if the information is not available.

CONNACTV (for REPLICA instances only)
Whether the instance currently has a pair of active connections to the active instance. Set to YES or NO.

HAINITDA (for ACTIVE instances only)
The date of the last log record recovered when the Native HA group initially became active.

HAINITL (for ACTIVE instances only)
The log sequence number (LSN) of the last log record recovered when the Native HA group initially became active, in the format <nnnnn:nnnnn:nnnnn:nnnnn>.

HAINITTI (for ACTIVE instances only)
The time of the last log record recovered when the Native HA group initially became active.

INSTANCE
The name of the Native HA instance.

INSYNC (for REPLICA instances only)
Whether this instance is currently considered in-sync with the active instance. Set to YES or NO.

REPLADDR
The network address and port to use when sending data to and from the specified instance.

ROLE
The current role of the instance in the Native HA group. Can be ACTIVE, REPLICA, or UNKNOWN.

See Native HA for a description of these roles.

If you use the DISPLAY QMSTATUS TYPE (NATIVEHA) command in an environment where Native HA is not supported or configured, the following message is returned:
AMQ5708E: Native HA not available.