Inquire Log (Response) on z/OS
The response to the Inquire Log (MQCMD_INQUIRE_LOG) command consists of the response header followed by the ParameterType structure and the combination of attribute parameter structures determined by the value of ParameterType.
- Always returned:
- ParameterType. Specifies the type of archive information
being returned. The value can be any of the following values:
- MQSYSP_TYPE_INITIAL
- The initial settings of the log parameters.
- MQSYSP_TYPE_SET
- The settings of the log parameters if they have been altered since their initial setting.
- MQSYSP_TYPE_LOG_COPY
- Information relating to the active log copy.
- MQSYSP_TYPE_LOG_STATUS
- Information relating to the status of the logs.
- Returned if ParameterType is MQSYSP_TYPE_INITIAL (one message is returned):
- DeallocateInterval , DualArchive , DualActive , DualBSDS , InputBufferSize , LogArchive , LogCompression , MaxArchiveLog , MaxConcurrentOffloads , MaxReadTapeUnits , OutputBufferCount , OutputBufferSize , ZHyperWrite
- Returned if ParameterType is MQSYSP_TYPE_SET and any value is set (one message is returned):
- DeallocateInterval , DualArchive , DualActive , DualBSDS , InputBufferSize , LogArchive , MaxArchiveLog , MaxConcurrentOffloads , MaxReadTapeUnits , OutputBufferCount , OutputBufferSize, ZHyperWrite
- Returned if ParameterType is MQSYSP_TYPE_LOG_COPY (one message is returned for each log copy):
- DataSetName , LogCopyNumber , LogUsed , ZHyperWrite, Encrypted
- Returned if ParameterType is MQSYSP_TYPE_LOG_STATUS (one message is returned):
- FullLogs, LogCompression, LogRBA, LogSuspend, OffloadStatus, QMgrStartDate, QMgrStartRBA, QMgrStartTime, TotalLogs
Response data - log parameter information
- DeallocateInterval (MQCFIN)
- Deallocation interval (parameter identifier: MQIACF_SYSP_DEALLOC_INTERVAL).
Specifies the length of time, in minutes, that an allocated archive read tape unit is allowed to remain unused before it is deallocated. The value can be in the range zero through 1440. If it is zero, the tape unit is deallocated immediately. If it is 1440, the tape unit is never deallocated.
- DualActive (MQCFIN)
- Specifies whether dual logging is being used (parameter identifier: MQIACF_SYSP_DUAL_ACTIVE).
The value can be any of the following values:
- MQSYSP_YES
- Dual logging is being used.
- MQSYSP_NO
- Dual logging is not being used.
- DualArchive (MQCFIN)
- Specifies whether dual archive logging is being used (parameter identifier:
MQIACF_SYSP_DUAL_ARCHIVE).
The value can be any of the following values:
- MQSYSP_YES
- Dual archive logging is being used.
- MQSYSP_NO
- Dual archive logging is not being used.
- DualBSDS (MQCFIN)
- Specifies whether dual BSDS is being used (parameter identifier: MQIACF_SYSP_DUAL_BSDS).
The value can be any of the following values:
- MQSYSP_YES
- Dual BSDS is being used.
- MQSYSP_NO
- Dual BSDS is not being used.
- Encrypted (MQCFIN)
- For MQSYSP_TYPE_LOG_COPY, shows whether the log copy is an encrypted data set (parameter
identifier: MQIACF_DS_ENCRYPTED)The value can be one of the following values:
- MQSYSP_YES
- The log data set is encrypted.
- MQSYSP_NO
- The log data set is not encrypted.
- InputBufferSize (MQCFIN)
- Specifies the size of input buffer storage for active and archive log data sets (parameter identifier: MQIACF_SYSP_IN_BUFFER_SIZE).
- LogArchive (MQCFIN)
- Specifies whether archiving is on or off (parameter identifier: MQIACF_SYSP_ARCHIVE).
The value can be any of the following values:
- MQSYSP_YES
- Archiving is on.
- MQSYSP_NO
- Archiving is off.
- LogCompression (MQCFIN)
- Specifies which log compression parameter is used (parameter identifier:
MQIACF_LOG_COMPRESSION).
The value can be any of the following values:
- MQCOMPRESS_NONE
- No log compression is performed.
- MQCOMPRESS_RLE
- Run-length encoding compression is performed.
- MQCOMPRESS_ANY
- Enable the queue manager to select the compression algorithm that gives the greatest degree of log record compression. Using this option currently results in RLE compression.
- MaxArchiveLog (MQCFIN)
- Specifies the maximum number of archive log volumes that can be recorded in the BSDS (parameter identifier: MQIACF_SYSP_MAX_ARCHIVE).
- MaxConcurrentOffloads (MQCFIN)
- Specifies the maximum number of concurrent log offload tasks (parameter identifier: MQIACF_SYSP_MAX_CONC_OFFLOADS).
- OutputBufferCount (MQCFIN)
- Specifies the number of output buffers to be filled before they are written to the active log data sets (parameter identifier: MQIACF_SYSP_OUT_BUFFER_COUNT).
- OutputBufferSize (MQCFIN)
- Specifies the size of output buffer storage for active and archive log data sets (parameter identifier: MQIACF_SYSP_OUT_BUFFER_SIZE).
- ZHyperWrite (MQCFIN)
- For MQSYSP_TYPE_INITIAL and
MQSYSP_TYPE_SET, shows whether writes to the active logs are made with
zHyperWrite being enabled, if the logs are on zHyperWrite capable volumes (parameter identifier:
MQIACF_SYSP_ZHYPERWRITE).The value can be one of the following values:
- MQSYSP_YES
- Writes are made using zHyperWrite, for active log datasets that are on zHyperWrite capable volumes.
- MQSYSP_NO
- Writes are not made using zHyperWrite.
Response data - to log status information
- DataSetName (MQCFST)
- The data set name of the active log data set (parameter identifier: MQCACF_DATA_SET_NAME).
If the copy is not currently active, this parameter is returned as blank.
The maximum length of the string is MQ_DATA_DATA_SET_NAME_LENGTH.
- FullLogs (MQCFIN)
- The total number of full active log data sets that have not yet been archived (parameter identifier: MQIACF_SYSP_FULL_LOGS).
- LogCompression (MQCFIN)
- Specifies the current log compression option (parameter identifier: MQIACF_LOG_COMPRESSION).
The value can be any of the following values:
- MQCOMPRESS_NONE
- Log compression is not enabled.
- MQCOMPRESS_RLE
- Run-length encoding log compression is enabled.
- MQCOMPRESS_ANY
- Any compression algorithm supported by the queue manager is enabled.
- LogCopyNumber (MQCFIN)
- Copy number (parameter identifier: MQIACF_SYSP_LOG_COPY).
- LogRBA (MQCFST)
- The RBA of the most recently written log record (parameter identifier: MQCACF_SYSP_LOG_RBA).
The maximum length of the string is MQ_RBA_LENGTH.
- LogSuspend (MQCFIN)
- Specifies whether logging is suspended (parameter identifier: MQIACF_SYSP_LOG_SUSPEND).
The value can be any of the following values:
- MQSYSP_YES
- Logging is suspended.
- MQSYSP_NO
- Logging is not suspended.
- LogUsed (MQCFIN)
- The percentage of the active log data set that has been used (parameter identifier: MQIACF_SYSP_LOG_USED).
- OffloadStatus (MQCFIN)
- Specifies the status of the offload task (parameter identifier: MQIACF_SYSP_OFFLOAD_STATUS).
The value can be any of the following values:
- MQSYSP_STATUS_ALLOCATING_ARCHIVE
- The offload task is busy, allocating the archive data set. MQSYSP_STATUS_ALLOCATING_ARCHIVE could indicate that a tape mount request is pending.
- MQSYSP_STATUS_COPYING_BSDS
- The offload task is busy, copying the BSDS data set.
- MQSYSP_STATUS_COPYING_LOG
- The offload task is busy, copying the active log data set.
- MQSYSP_STATUS_BUSY
- The offload task is busy with other processing.
- MQSYSP_STATUS_AVAILABLE
- The offload task is waiting for work.
- QMgrStartDate (MQCFST)
- The date on which the queue manager was started, in the form yyyy-mm-dd
(parameter identifier: MQCACF_SYSP_Q_MGR_DATE).
The maximum length of the string is MQ_DATE_LENGTH.
- QMgrStartRBA (MQCFST)
- The RBA from which logging began when the queue manager was started (parameter identifier:
MQCACF_SYSP_Q_MGR_RBA).
The maximum length of the string is MQ_RBA_LENGTH.
- QMgrStartTime (MQCFST)
- The time that the queue manager was started, in the form hh.mm.ss (parameter
identifier: MQCACF_SYSP_Q_MGR_TIME).
The maximum length of the string is MQ_TIME_LENGTH.
- TotalLogs (MQCFIN)
- The total number of active log data sets (parameter identifier: MQIACF_SYSP_TOTAL_LOGS).
Parent topic: Definitions of the Programmable Command Formats