Inquire Queue Manager Status on Multiplatforms

The Inquire Queue Manager Status (MQCMD_INQUIRE_Q_MGR_STATUS) command inquires about the status of the local queue manager.

Optional parameters

QMStatusAttrs (MQCFIL)

Queue manager status attributes (parameter identifier: MQIACF_Q_MGR_STATUS_ATTRS). The attribute list might specify the following value on its own - default value used if the parameter is not specified:

MQIACF_ALL

All attributes.

or a combination of the following:

MQCA_Q_MGR_NAME

Name of the local queue manager.

MQCA_INSTALLATION_DESC

Description of the installation associated with the queue manager.

MQCA_INSTALLATION_NAME

Name of the installation associated with the queue manager.

MQCA_INSTALLATION_PATH

Path of the installation associated with the queue manager.

MQCACF_ARCHIVE_LOG_EXTENT_NAME)

Name of the oldest log extent for which the queue manager is waiting for archive notification.

The maximum length of the string is MQ_LOG_EXTENT_NAME_LENGTH.

If the queue manager is not using archive log management, this attribute is blank. This parameter is not valid on IBM i.

MQCACF_CURRENT_LOG_EXTENT_NAME

Name of the log extent currently being written to by the logger. MQCACF_CURRENT_LOG_EXTENT_NAME is available only on queue managers using linear logging. On other queue managers, MQCACF_CURRENT_LOG_EXTENT_NAME is blank.

MQCACF_LOG_PATH

Location of the recovery log extents.

MQCACF_MEDIA_LOG_EXTENT_NAME

Name of the earliest log extent required to perform media recovery. MQCACF_MEDIA_LOG_EXTENT_NAME is available only on queue managers using linear logging. On other queue managers, MQCACF_MEDIA_LOG_EXTENT_NAME is blank.

MQCACF_RESTART_LOG_EXTENT_NAME

Name of the earliest log extent required to perform restart recovery. MQCACF_RESTART_LOG_EXTENT_NAME is available only on queue managers using linear logging. On other queue managers, MQCACF_RESTART_LOG_EXTENT_NAME is blank.

MQCACF_Q_MGR_START_DATE

The date on which the queue manager was started (in the form yyyy-mm-dd). The length of this attribute is given by MQ_DATE_LENGTH.

MQCACF_Q_MGR_START_TIME

The time at which the queue manager was started (in the form hh.mm.ss). The length of this attribute is given by MQ_TIME_LENGTH.

MQIACF_ARCHIVE_LOG_SIZE

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

This attribute is not valid on IBM i.

MQIACF_CHINIT_STATUS

Current status of the channel initiator.

MQIACF_LDAP_CONNECTION_STATUS

Current status of the connection to the LDAP server.

MQIACF_CMD_SERVER_STATUS

Current status of the command server.

MQIACF_CONNECTION_COUNT

Current number of connections to the queue manager.

MQIACF_LOG_IN_USE

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

This attribute is not valid on IBM i.

MQIACF_LOG_UTILIZATION

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

This attribute is not valid on IBM i.

MQIACF_MEDIA_LOG_SIZE

Current size of the log data required for media recovery in megabytes.

This attribute is not valid on IBM i.

MQIACF_Q_MGR_STATUS

Current status of the queue manager.

MQIACF_Q_MGR_STATUS_LOG

Current status of all the log attributes. The attributes can be any of the following:

• MQCACF_ARCHIVE_LOG_EXTENT_NAME
• MQIACF_ARCHIVE_LOG_SIZE
• MQCACF_CURRENT_LOG_EXTENT_NAME
• MQIACF_LOG_IN_USE
• MQIACF_LOG_UTILIZATION
• MQCACF_MEDIA_LOG_EXTENT_NAME
• MQIACF_MEDIA_LOG_SIZE
• MQCACF_RESTART_LOG_EXTENT_NAME
• MQIACF_RESTART_LOG_SIZE
• MQIACF_REUSABLE_LOG_SIZE

MQIACF_RESTART_LOG_SIZE

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

This attribute is not valid on IBM i.

MQIACF_REUSABLE_LOG_SIZE

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

This attribute is not valid on IBM i.

Parent topic: Definitions of the Programmable Command Formats