Inquire Queue Manager Status (Response) on Multiplatforms
The response to the Inquire Queue Manager Status (MQCMD_INQUIRE_Q_MGR_STATUS) command consists of the response header followed by the QMgrName and QMgrStatus structures and the requested combination of attribute parameter structures.
- Always returned:
- QMgrName, QMgrStatus
- Returned if requested:
- ArchiveLog, ArchiveLogSize, ChannelInitiatorStatus, CommandServerStatus, ConnectionCount, CurrentLog, InstallationDesc, InstallationName, InstallationPath, LDAPConnectionStatus, LogInUse, LogPath, LogUtilization, MediaRecoveryLog, MediaRecoveryLogSize, RestartRecoveryLogSize, ReusableLogSize, StartDate, StartTime
Response data
- ArchiveLog (MQCFST)
- Name of the oldest log extent for which the queue manager is waiting for archive notification or blank if they have all been archived (parameter identifier MQCACF_ARCHIVE_LOG_EXTENT_NAME).
- ArchiveLogSize (MQCFIN)
- 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 (parameter identifier MQIACF_ARCHIVE_LOG_SIZE).
- ChannelInitiatorStatus (MQCFIN)
- Status of the channel initiator reading SYSTEM.CHANNEL.INITQ (parameter identifier:
MQIACF_CHINIT_STATUS).
The value can be:
- MQSVC_STATUS_STOPPED
- The channel initiator is not running.
- MQSVC_STATUS_STARTING
- The channel initiator is in the process of initializing.
- MQSVC_STATUS_RUNNING
- The channel initiator is fully initialized and is running.
- MQSVC_STATUS_STOPPING
- The channel initiator is stopping.
- CommandServerStatus (MQCFIN)
- Status of the command server (parameter identifier: MQIACF_CMD_SERVER_STATUS).
The value can be:
- MQSVC_STATUS_STARTING
- The command server is in the process of initializing.
- MQSVC_STATUS_RUNNING
- The command server is fully initialized and is running.
- MQSVC_STATUS_STOPPING
- The command server is stopping.
- ConnectionCount (MQCFIN)
- Connection count (parameter identifier: MQIACF_CONNECTION_COUNT).
The current number of connections to the queue manager.
- CurrentLog (MQCFST)
- Log extent name (parameter identifier: MQCACF_CURRENT_LOG_EXTENT_NAME).
The name of the log extent that was being written to at the time of the Inquire command. If the queue manager is using circular logging, this parameter is blank.
The maximum length of the string is MQ_LOG_EXTENT_NAME_LENGTH.
- InstallationDesc (MQCFST)
- Installation Description (parameter identifier: MQCA_INSTALLATION_DESC)
The installation description for this queue manager.
- InstallationName (MQCFST)
- Installation Name (parameter identifier: MQCA_INSTALLATION_NAME)
The installation name for this queue manager.
- InstallationPath (MQCFST)
- Installation Path (parameter identifier: MQCA_INSTALLATION_PATH)
The installation path for this queue manager.
- LDAPConnectionStatus (MQCFIN)
- Current status of the queue manager's connection to the LDAP server (parameter identifier:
MQIACF_LDAP_CONNECTION_STATUS).
The value can be:
- MQLDAPC_CONNECTED
- The queue manager currently has a connection to the LDAP server.
- MQLDAPC_ERROR
- The queue manager attempted to make a connection to the LDAP server and failed.
- MQLDAPC_INACTIVE
- The queue manager is not configured to use an LDAP server or has not yet made a connection to the LDAP server.
- LogInUse (MQCFIN)
- Current size of the percentage of the primary log space in use for restart recovery at this point in time (parameter identifier MQIACF_LOG_IN_USE).
- LogPath (MQCFST)
- Location of the recovery log extents (parameter identifier: MQCACF_LOG_PATH).
This parameter identifies the directory where log files are created by the queue manager.
The maximum length of the string is MQ_LOG_PATH_LENGTH.
- LogUtilization (MQCFIN)
- Current percentage estimate of how well the queue manager workload is contained within the primary log space (parameter identifier MQIACF_LOG_UTILIZATION).
- MediaRecoveryLog (MQCFST)
- Name of the oldest log extent required by the queue manager to perform media recovery (parameter
identifier: MQCACF_MEDIA_LOG_EXTENT_NAME). This parameter is available only on
queue managers using linear logging. If the queue manager is using circular logging, this parameter
is blank.
The maximum length of the string is MQ_LOG_EXTENT_NAME_LENGTH.
- MediaRecoveryLogSize (MQCFIN)
- Current size of the log data required for media recovery in megabytes (parameter identifier MQIACF_MEDIA_LOG_SIZE).
- QMgrName (MQCFST)
- Name of the local queue manager (parameter identifier: MQCA_Q_MGR_NAME).
The maximum length of the string is MQ_Q_MGR_NAME_LENGTH.
- QMgrStatus (MQCFIN)
- Current execution status of the queue manager (parameter identifier: MQIACF_Q_MGR_STATUS).
The value can be:
- MQQMSTA_STARTING
- The queue manager is initializing.
- MQQMSTA_RUNNING
- The queue manager is fully initialized and is running.
- MQQMSTA_QUIESCING
- The queue manager is quiescing.
- RestartRecoveryLog (MQCFST)
- Name of the oldest log extent required by the queue manager to perform restart recovery
(parameter identifier: MQCACF_RESTART_LOG_EXTENT_NAME).
This parameter is available only on queue managers using linear logging. If the queue manager is using circular logging, this parameter is blank.
The maximum length of the string is MQ_LOG_EXTENT_NAME_LENGTH.
- RestartRecoveryLogSize (MQCFIN)
- Size of the log data required for restart recovery in megabytes (parameter identifier MQIACF_RESTART_LOG_SIZE).
- ReusableLogSize (MQCFIN)
- The amount of space occupied, in megabytes, by log extents available to be reused (parameter identifier MQIACF_REUSABLE_LOG_SIZE).
- StartDate (MQCFST)
- Date when this queue manager was started (in the form yyyy-mm-dd) (parameter
identifier: MQCACF_Q_MGR_START_DATE).
The maximum length of the string is MQ_DATE_LENGTH.
- StartTime (MQCFST)
- Time when this queue manager was started (in the form hh:mm:ss) (parameter
identifier: MQCACF_Q_MGR_START_TIME).
The maximum length of the string is MQ_TIME_LENGTH.
Parent topic: Definitions of the Programmable Command Formats