DISPLAY QMSTATUS (display queue manager status) on Multiplatforms

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 for TYPE(NATIVEHA) 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.

TYPE

The type of status information to display. The value can be one of the following values:

QMGR

Status information that relates to the queue manager. This is the default value.

NATIVEHA

Status information that relates to Native HA instances and groups.

NHATYPE

Specify this parameter to select the Native HA information type that is displayed. This parameter can be specified only with TYPE(NATIVEHA). The value can be one of the following values:

INSTANCE

Display information about all instances in the local group. This is the default setting.

GROUP

Display information about all Native HA groups.

ALL

Display information about all Native HA instances and groups.

WHERE

Use with the TYPE(NATIVEHA) parameter to specify a filter condition to display status information for queue managers that satisfy the selection criterion of the filter condition. The filter condition is in three parts: filter-keyword, operator, and filter-value:

filter-keyword

Any parameter that can be used to display attributes for this DISPLAY command. You cannot use the TYPE(NATIVEHA) parameter itself as a filter keyword.

operator

The operator is used to determine whether a queue manager satisfies the filter value on the given filter keyword. The operators are:

LT

Less than

GT

Greater than

EQ

Equal to

NE

Not equal to

LE

Less than or equal to

GE

Greater than or equal to

LK

Matches a generic string that you provide as a filter-value

NL

Does not match a generic string that you provide as a filter-value

CT

Contains a specified item. If the filter-keyword is a list, you can use this filter to display objects whose attributes contain the specified item.

EX

Does not contain a specified item. If the filter-keyword is a list, you can use this filter to display objects whose attributes do not contain the specified item.

filter-value

The value that the attribute value must be tested against using the operator. Depending on the filter-keyword, this value can be:

• An explicit value, that is a valid value for the attribute being tested.

  You can use operators LT, GT, EQ, NE, LE, or GE only. However, if the attribute value is one from a possible set of values on a parameter (for example, the value NO on the UNCOM parameter), you can only use EQ or NE.

• A generic value. This value is a character string with an asterisk at the end, for example ABC*. If the operator is LK, all items where the attribute value begins with the string (ABC in the example) are listed. If the operator is NL, all items where the attribute value does not begin with the string are listed. Only a single trailing wildcard character (asterisk) is permitted.

  You cannot use a generic filter-value for parameters with numeric values or with one of a set of values.

• An item in a list of values. The operator must be CT or EX. If it is a character value, it can be explicit or generic. For example, if the value DEF is specified with the operator CT, all items where one of the attribute values is DEF are listed. If ABC* is specified, all items where one of the attribute values begins with ABC are listed.

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.

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.

This parameter is not valid on IBM i.

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.

CHKPTCNT

The total number of checkpoints that have taken place on this queue manager.

CHKPTOPS

The number of operations checkpointed on this queue manager since the last checkpoint.

CHKPTSZ

The amount of data checkpointed on this queue manager since the last checkpoint, in MB, rounded up.

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.

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

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

DATPATH

The path of the queue manager data directory.

DISKLSN

The LSN of the recovery log that has been written and forced to disk.

This parameter is not valid on IBM i.

GRPLSN

Specifies the LSN that has been replicated between a quorum of instances in a Native HA group, in <nnnnn:nnnnn:nnnnn:nnnnn> format.

GRPNAME

Specifies the name of a Native HA group. Blank if a name has not been configured.

GRPROLE

Specifies the current role of a Native HA group and is one of:

Live

A live group

Recovery

A recovery group

Pending live

A group waiting to become Live

Pending recovery

A group waiting to become Recovery

Unknown

The current role cannot be determined

Not configured

Native HA has not been configured

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.

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.

LOGEXTSZ

The size of each log file (or the threshold of the currently attached journal receiver on IBM i) in KB.

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

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.

This parameter is not valid on IBM i.

LOGPATH

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

LOGPRIM

The number of primary log files.

This parameter is not valid on IBM i.

LOGSEC

The maximum number of secondary log files.

This parameter is not valid on IBM i.

LOGSTRDA

The date for the last log record recovered when the queue manager started.

This parameter is not valid on IBM i.

LOGSTRL

The log sequence number (LSN) for the last log record recovered when the queue manager started, in <nnnnn:nnnnn:nnnnn:nnnnn> format.

This parameter is not valid on IBM i.

LOGSTRTI

The time for the last log record recovered when the queue manager was started.

This parameter is not valid on IBM i.

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.

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.

This parameter is not valid on IBM i.

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.

Returned on the IBM MQ Appliance only.

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.

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.

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.

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.

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.

UNICLUS

The name of the uniform cluster that the queue manager is a member of, or blank otherwise.

ACKLSN

Indicates the LSN that the instance has acknowledged as having been written to the recovery log, in <nnnnn:nnnnn:nnnnn:nnnnn> format. Blank if the LSN value is not known.

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.

BACKLOG (for groups)

Native HA group backlog. Only for Recovery or Pending live groups in a Native HA cross-region replication configuration.

CONNACTV (for REPLICA instances only)

Whether the instance currently has a pair of active connections to the active instance. Set to YES or NO.

CONNGRP

Indicates whether the group is connected to a live or pending recovery group. Only applies to recovery, pending live, or unknown groups in a Native HA cross-region replication configuration. Set to one of the following values:

Yes

The group is connected.

No

The group is disconnected.

Suspended

The group is connected, but the group cannot replicate data until a configuration incompatibility between the groups is resolved. (This can occur if there is a version incompatibility, for example.)

GRPADDR

The IP address of the group.

GRSTATUS

Indicates the operational status of this group and is one of the following values:

Normal

The group is operating normally.

Checking

The group is being checked to ensure the consistency of the recovery log.

Synchronizing

The group is being sent data to bring it in sync.

Rebasing

A new recovery log is being sent to the instance.

Disk full

The group has a full disk.

Disconnected

Cannot communicate with the group.

Partitioned

Two groups believe they are the Live group (that is, a 'split brain' status).

Unknown

The group status is unknown.

GRPVER

Indicates the version of the current group leader.

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.

HASTATUS

Indicates the operational status of this instance and is one of the following values:

Normal

The instance is operating normally.

Checking

The instance is being checked to ensure the consistency of the recovery log.

Synchronizing

The instance is being sent data to bring it in-sync.

Rebasing

A new recovery log is being sent to the instance.

Disk full

The instance has a full disk.

Disconnected

Cannot communicate with the instance.

Unknown

The instance status is unknown.

INITLSN

The log sequence number (LSN) of the last log record recovered when the Native HA group initially became live, in the format <nnnnn:nnnnn:nnnnn:nnnnn>.

Only for live or pending recovery groups in a Native HA cross-region replication configuration.

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. Is either YES or NO.

INSYNC (for groups)

Indicates whether the group could become Live with no loss of data if a failover occurred. (Note that a Recovery group might not be in-sync with the Live group very often because the log is replicated asynchronously. Use the RCOVLSN and RCOVTIME values to indicate if data loss might occur on an unplanned failover.) Only for recovery or pending live groups in a Native HA cross-region replication configuration.

INITTIME

The time of the last log record recovered when the Native HA group initially became live, in ISO 8601 format. Only for live or pending recovery groups in a Native HA cross-region replication configuration.

LIVETIME

The time the group first became the live group, in ISO 8601 format. Only for live or pending recovery groups in a Native HA cross-region replication configuration.

NHATYPE

Native HA information type. Can be one of the following values:

INSTANCE

Information about an instance in a Native HA group.

GROUP

Information about a Native HA group.

RCOVLSN

A log sequence number (LSN) that the group could recover to. Given in the format <nnnnn:nnnnn:nnnnn:nnnnn>.

RCOVTIME

A time that the group could recover to, in ISO 8601 format.

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 one of:

ACTIVE

An active instance is processing messages and writing to the recovery log.

REPLICA

A replica instance is writing replicated data to its own recovery log and updating its own queue data from the replicated recovery log.

LEADER

The leader in a Native HA CRR Recovery group.

UNKNOWN

The current role is not known.

See Native HA for a more detailed description of these roles.

SYNCTIME

Indicates the time when this group was last in-sync with the Live group, in ISO 8601 format. (Note that a Recovery group might not be in-sync with the Live group very often because the log is replicated asynchronously. Use the RCOVLSN and RCOVTIME values to indicate if data loss might occur on an unplanned failover.) Only for Recovery or Pending live groups in a Native HA cross-region replication configuration.

AMQ5708E: Native HA not available.