Inquire Queue (Response)
The response to the Inquire Queue command MQCMD_INQUIRE_Q consists of the response header followed by the QName structure. On z/OS® only, response includes the QSGDisposition structure, and the requested combination of attribute parameter structures.
If a generic queue name was specified, or cluster queues requested, by setting either MQQT_CLUSTER or MQIACF_CLUSTER_INFO, one message is generated for each queue found.
- Always returned:
- QName, QSGDisposition, QType
- Returned if requested:
- AlterationDate , AlterationTime , BackoutRequeueName , BackoutThreshold , BaseQName , , CFStructure , ClusterChannelName , ClusterDate , ClusterName , ClusterNamelist , ClusterQType , ClusterTime , CLWLQueuePriority , CLWLQueueRank , CLWLUseQ , CreationDate , CreationTime , CurrentQDepth , Custom , DefaultPutResponse , DefBind , DefinitionType , DefInputOpenOption , DefPersistence , DefPriority , DefReadAhead , DistLists , HardenGetBackout , Imgrcovq , IndexType , InhibitGet , InhibitPut , InitiationQName , MaxMsgLength , MaxQDepth , MsgDeliverySequence , NonPersistentMessageClass , OpenInputCount , OpenOutputCount , PageSetID , ProcessName , PropertyControl , QDepthHighEvent , QDepthHighLimit , QDepthLowEvent , QDepthLowLimit , QDepthMaxEvent , QDesc , QMgrIdentifier , QMgrName , QServiceInterval , QServiceIntervalEvent , QueueAccounting , QueueMonitoring , QueueStatistics , RemoteQMgrName , RemoteQName , RetentionInterval , Scope , Shareability , StorageClass , TpipeNames , TriggerControl , TriggerData , TriggerDepth , TriggerMsgPriority , TriggerType , Usage , XmitQName
Response data
- AlterationDate (MQCFST)
- Alteration date (parameter identifier: MQCA_ALTERATION_DATE).
The date when the information was last altered, in the form yyyy-mm-dd.
- AlterationTime (MQCFST)
- Alteration time (parameter identifier: MQCA_ALTERATION_TIME).
The time when the information was last altered, in the form hh.mm.ss.
- BackoutRequeueName (MQCFST)
- Excessive backout requeue name (parameter identifier: MQCA_BACKOUT_REQ_Q_NAME).
The maximum length of the string is MQ_Q_NAME_LENGTH.
- BackoutThreshold (MQCFIN)
- Backout threshold (parameter identifier: MQIA_BACKOUT_THRESHOLD).
- BaseQName (MQCFST)
- Queue name to which the alias resolves (parameter identifier:
MQCA_BASE_Q_NAME).
The name of a queue that is defined to the local queue manager.
The maximum length of the string is MQ_Q_NAME_LENGTH.
- CFStructure (MQCFST)
- Coupling facility structure name (parameter identifier: MQCA_CF_STRUC_NAME).
This parameter applies to z/OS only.
Specifies the name of the coupling facility structure where you want to store messages when you use shared queues.
The maximum length of the string is MQ_CF_STRUC_NAME_LENGTH.
- ClusterChannelName (MQCFST)
- Cluster-sender channel name (parameter identifier: MQCA_CLUS_CHL_NAME).
ClusterChannelName is the generic name of the cluster-sender channels that use this queue as a transmission queue.
The maximum length of the channel name is: MQ_CHANNEL_NAME_LENGTH.
- ClusterDate (MQCFST)
- Cluster date (parameter identifier: MQCA_CLUSTER_DATE).
The date on which the information became available to the local queue manager, in the form yyyy-mm-dd.
- ClusterName (MQCFST)
- Cluster name (parameter identifier: MQCA_CLUSTER_NAME).
- ClusterNamelist (MQCFST)
- Cluster namelist (parameter identifier: MQCA_CLUSTER_NAMELIST).
- ClusterQType (MQCFIN)
- Cluster queue type (parameter identifier: MQIA_CLUSTER_Q_TYPE).
The value can be:
- MQCQT_LOCAL_Q
- The cluster queue represents a local queue.
- MQCQT_ALIAS_Q
- The cluster queue represents an alias queue.
- MQCQT_REMOTE_Q
- The cluster queue represents a remote queue.
- MQCQT_Q_MGR_ALIAS
- The cluster queue represents a queue manager alias.
- ClusterTime (MQCFST)
- Cluster time (parameter identifier: MQCA_CLUSTER_TIME).
The time at which the information became available to the local queue manager, in the form hh.mm.ss.
- CLWLQueuePriority (MQCFIN)
- Cluster workload queue priority (parameter identifier: MQIA_CLWL_Q_PRIORITY).
Priority of the queue in cluster workload management. The value is in the range zero through 9, where zero is the lowest priority and 9 is the highest.
- CLWLQueueRank (MQCFIN)
- Cluster workload queue rank (parameter identifier: MQIA_CLWL_Q_RANK).
Rank of the queue in cluster workload management. The value is in the range zero through 9, where zero is the lowest rank and 9 is the highest.
- CLWLUseQ (MQCFIN)
- Cluster workload queue rank (parameter identifier: MQIA_CLWL_USEQ).
The value can be:
- MQCLWL_USEQ_AS_Q_MGR
- Use the value of the CLWLUseQ parameter on the queue manager's definition.
- MQCLWL_USEQ_ANY
- Use remote and local queues.
- MQCLWL_USEQ_LOCAL
- Do not use remote queues.
- CreationDate (MQCFST)
- Queue creation date, in the form yyyy-mm-dd (parameter identifier:
MQCA_CREATION_DATE).
The maximum length of the string is MQ_CREATION_DATE_LENGTH.
- CreationTime (MQCFST)
- Creation time, in the form hh.mm.ss (parameter identifier:
MQCA_CREATION_TIME).
The maximum length of the string is MQ_CREATION_TIME_LENGTH.
- CurrentQDepth (MQCFIN)
- Current queue depth (parameter identifier: MQIA_CURRENT_Q_DEPTH).
- Custom (MQCFST)
- Custom attribute for new features (parameter identifier: MQCA_CUSTOM).
This attribute is reserved for the configuration of new features before separate attributes are named. It can contain the values of zero or more attributes as pairs of attribute name and value, separated by at least one space. The attribute name-value pairs have the form NAME(VALUE).
This description is updated when features using this attribute are introduced.
- DefaultPutResponse (MQCFIN)
- Default put response type definition (parameter identifier:
MQIA_DEF_PUT_RESPONSE_TYPE).
The parameter specifies the type of response to be used for put operations to the queue when an
application specifies MQPMO_RESPONSE_AS_Q_DEF. The value can be any of the following values:
- MQPRT_SYNC_RESPONSE
- The put operation is issued synchronously, returning a response.
- MQPRT_ASYNC_RESPONSE
- The put operation is issued asynchronously, returning a subset of MQMD fields.
- DefBind (MQCFIN)
- Default binding (parameter identifier: MQIA_DEF_BIND).
The value can be:
- MQBND_BIND_ON_OPEN
- Binding fixed by MQOPEN call.
- MQBND_BIND_NOT_FIXED
- Binding not fixed.
- MQBND_BIND_ON_GROUP
- Allows an application to request that a group of messages are all allocated to the same destination instance.
- DefinitionType (MQCFIN)
- Queue definition type (parameter identifier: MQIA_DEFINITION_TYPE).
The value can be:
- MQQDT_PREDEFINED
- Predefined permanent queue.
- MQQDT_PERMANENT_DYNAMIC
- Dynamically defined permanent queue.
- MQQDT_SHARED_DYNAMIC
- Dynamically defined shared queue. This option is available on z/OS only.
- MQQDT_TEMPORARY_DYNAMIC
- Dynamically defined temporary queue.
- DefInputOpenOption (MQCFIN)
- Default input open option for defining whether queues can be shared (parameter identifier:
MQIA_DEF_INPUT_OPEN_OPTION).
The value can be:
- MQOO_INPUT_EXCLUSIVE
- Open queue to get messages with exclusive access.
- MQOO_INPUT_SHARED
- Open queue to get messages with shared access.
- DefPersistence (MQCFIN)
- Default persistence (parameter identifier: MQIA_DEF_PERSISTENCE).
The value can be:
- MQPER_PERSISTENT
- Message is persistent.
- MQPER_NOT_PERSISTENT
- Message is not persistent.
- DefPriority (MQCFIN)
- Default priority (parameter identifier: MQIA_DEF_PRIORITY).
- DefReadAhead (MQCFIN)
- Default read ahead (parameter identifier: MQIA_DEF_READ_AHEAD).
Specifies the default read ahead behavior for non-persistent messages delivered to the client.
The value can be any of the following values:- MQREADA_NO
- Non-persistent messages are not sent ahead to the client before an application requests them. A maximum of one non-persistent message can be lost if the client ends abnormally.
- MQREADA_YES
- Non-persistent messages are sent ahead to the client before an application requests them. Non-persistent messages can be lost if the client ends abnormally or if the client does not consume all the messages it is sent.
- MQREADA_DISABLED
- Read ahead of non-persistent messages in not enabled for this queue. Messages are not sent ahead to the client regardless of whether read ahead is requested by the client application.
- DistLists (MQCFIN)
- Distribution list support (parameter identifier: MQIA_DIST_LISTS).
The value can be:
- MQDL_SUPPORTED
- Distribution lists supported.
- MQDL_NOT_SUPPORTED
- Distribution lists not supported.
This parameter is supported only on Multiplatforms.
- HardenGetBackout (MQCFIN)
- Harden backout, or not: (parameter identifier: MQIA_HARDEN_GET_BACKOUT).
The value can be:
- MQQA_BACKOUT_HARDENED
- Backout count remembered.
- MQQA_BACKOUT_NOT_HARDENED
- Backout count may not be remembered.
- ImageRecoverQueue (MQCFST)
- Specifies whether a local or permanent dynamic queue object is recoverable from a media image,
if linear logging is being used (parameter identifier: MQIA_MEDIA_IMAGE_RECOVER_Q).
This parameter is not valid on z/OS. Possible
values are:
- MQIMGRCOV_YES
- These queue objects are recoverable.
- MQIMGRCOV_NO
- Automatic media images, if enabled, are not written for these objects.
- MQIMGRCOV_AS_Q_MGR
- If the ImageRecoverQueue attribute for the queue manager specifies
MQIMGRCOV_YES , these queue objects are recoverable.
If the ImageRecoverQueue attribute for the queue manager specifies MQIMGRCOV_NO, the rcdmqimg (record media image) andrcrmqobj (re-create object) commands are not permitted for these objects, and automatic media images, if enabled, are not written for these objects.
- IndexType (MQCFIN)
- Index type (parameter identifier: MQIA_INDEX_TYPE). This parameter applies to
z/OS only.
Specifies the type of index maintained by the queue manager to expedite MQGET
operations on the queue. The value can be any of the following values:
- MQIT_NONE
- No index.
- MQIT_MSG_ID
- The queue is indexed using message identifiers.
- MQIT_CORREL_ID
- The queue is indexed using correlation identifiers.
- MQIT_MSG_TOKEN
- The queue is indexed using message tokens.
- MQIT_GROUP_ID
- The queue is indexed using group identifiers.
- InhibitGet (MQCFIN)
- Get operations are allowed or inhibited: (parameter identifier:
MQIA_INHIBIT_GET).
The value can be:
- MQQA_GET_ALLOWED
- Get operations are allowed.
- MQQA_GET_INHIBITED
- Get operations are inhibited.
- InhibitPut (MQCFIN)
- Putt operations are allowed or inhibited: (parameter identifier:
MQIA_INHIBIT_PUT).
The value can be:
- MQQA_PUT_ALLOWED
- Put operations are allowed.
- MQQA_PUT_INHIBITED
- Put operations are inhibited.
- InitiationQName (MQCFST)
- Initiation queue name (parameter identifier: MQCA_INITIATION_Q_NAME).
The maximum length of the string is MQ_Q_NAME_LENGTH.
- MaxMsgLength (MQCFIN)
- Maximum message length (parameter identifier: MQIA_MAX_MSG_LENGTH).
- MaxQDepth (MQCFIN)
- Maximum queue depth (parameter identifier: MQIA_MAX_Q_DEPTH).
- MsgDeliverySequence (MQCFIN)
- Messages ordered by priority or sequence: (parameter identifier:
MQIA_MSG_DELIVERY_SEQUENCE).
The value can be:
- MQMDS_PRIORITY
- Messages are returned in priority order.
- MQMDS_FIFO
- Messages are returned in FIFO order (first in, first out).
- NonPersistentMessageClass (MQCFIN)
- The level of reliability assigned to non-persistent messages that are put to the queue
(parameter identifier: MQIA_NPM_CLASS).
Specifies the circumstances under which non-persistent messages put to the queue may be lost. The
value can be any of the following values:
- MQNPM_CLASS_NORMAL
- Non-persistent messages are limited to the lifetime of the queue manager session. They are discarded in the event of a queue manager restart. MQNPM_CLASS_NORMAL is the default value.
- MQNPM_CLASS_HIGH
- The queue manager attempts to retain non-persistent messages for the lifetime of the queue. Non-persistent messages may still be lost in the event of a failure.
- OpenInputCount (MQCFIN)
- Number of MQOPEN calls that have the queue open for input (parameter identifier: MQIA_OPEN_INPUT_COUNT).
- OpenOutputCount (MQCFIN)
- Number of MQOPEN calls that have the queue open for output (parameter identifier: MQIA_OPEN_OUTPUT_COUNT).
- PageSetID (MQCFIN)
- Page set identifier (parameter identifier: MQIA_PAGESET_ID).
Specifies the identifier of the page set on which the queue resides.
This parameter applies to z/OS only when the queue is actively associated with a page set.
- ProcessName (MQCFST)
- Name of process definition for queue (parameter identifier: MQCA_PROCESS_NAME).
The maximum length of the string is MQ_PROCESS_NAME_LENGTH.
- PropertyControl (MQCFIN)
- Property control attribute (parameter identifier MQIA_PROPERTY_CONTROL).
Specifies how message properties are handled for messages that are retrieved from queues using
the MQGET call with the MQGMO_PROPERTIES_AS_Q_DEF option. The
value can be any of the following values:
- MQPROP_COMPATIBILITY
- If the message contains a property with a prefix of mcd., jms., usr. or mqext., all message properties are delivered to the application in an MQRFH2 header. Otherwise all properties of the message, except properties contained in the message descriptor (or extension), are discarded and are no longer accessible to the application.
- MQPROP_NONE
- All properties of the message are removed from the message before the message is sent to the remote queue manager. Properties in the message descriptor (or extension) are not removed.
- MQPROP_ALL
- All properties of the message are included with the message when it is sent to the remote queue manager. The properties are placed in one or more MQRFH2 headers in the message data. Properties in the message descriptor (or extension) are not placed in MQRFH2 headers.
- MQPROP_FORCE_ MQRFH2
- Properties are always returned in the message data in an MQRFH2 header regardless of whether the application specifies a message handle.
This parameter is applicable to local, alias, and model queues.
- QDepthHighEvent (MQCFIN)
- Controls whether Queue Depth High events are generated (parameter identifier:
MQIA_Q_DEPTH_HIGH_EVENT).
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
- QDepthHighLimit (MQCFIN)
- High limit for queue depth (parameter identifier: MQIA_Q_DEPTH_HIGH_LIMIT).
The threshold against which the queue depth is compared to generate a Queue Depth High event.
- QDepthLowEvent (MQCFIN)
- Controls whether Queue Depth Low events are generated (parameter identifier:
MQIA_Q_DEPTH_LOW_EVENT).
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
- QDepthLowLimit (MQCFIN)
- Low limit for queue depth (parameter identifier: MQIA_Q_DEPTH_LOW_LIMIT).
The threshold against which the queue depth is compared to generate a Queue Depth Low event.
- QDepthMaxEvent (MQCFIN)
- Controls whether Queue Full events are generated (parameter identifier:
MQIA_Q_DEPTH_MAX_EVENT).
The value can be:
- MQEVR_DISABLED
- Event reporting disabled.
- MQEVR_ENABLED
- Event reporting enabled.
- QDesc (MQCFST)
- Queue description (parameter identifier: MQCA_Q_DESC).
The maximum length of the string is MQ_Q_DESC_LENGTH.
- QMgrIdentifier (MQCFST)
- Queue manager identifier (parameter identifier: MQCA_Q_MGR_IDENTIFIER).
The unique identifier of the queue manager.
- QMgrName (MQCFST)
- Name of local queue manager (parameter identifier: MQCA_CLUSTER_Q_MGR_NAME).
The maximum length of the string is MQ_Q_MGR_NAME_LENGTH.
- QName (MQCFST)
- Queue name (parameter identifier: MQCA_Q_NAME).
The maximum length of the string is MQ_Q_NAME_LENGTH.
- QServiceInterval (MQCFIN)
- Target for queue service interval (parameter identifier:
MQIA_Q_SERVICE_INTERVAL).
The service interval used for comparison to generate Queue Service Interval High and Queue Service Interval OK events.
- QServiceIntervalEvent (MQCFIN)
- Controls whether Service Interval High or Service Interval OK events are generated (parameter
identifier: MQIA_Q_SERVICE_INTERVAL_EVENT).
The value can be:
- MQQSIE_HIGH
- Queue Service Interval High events enabled.
- MQQSIE_OK
- Queue Service Interval OK events enabled.
- MQQSIE_NONE
- No queue service interval events enabled.
- QSGDisposition (MQCFIN)
- QSG disposition (parameter identifier: MQIA_QSG_DISP).
Specifies the disposition of the object (that is, where it is defined and how it behaves).
QSGDisposition is valid only on z/OS. The value can be any of the following values:
- MQQSGD_COPY
- The object is defined as MQQSGD_COPY.
- MQQSGD_GROUP
- The object is defined as MQQSGD_GROUP.
- MQQSGD_Q_MGR
- The object is defined as MQQSGD_Q_MGR.
- MQQSGD_SHARED
- The object is defined as MQQSGD_SHARED.
- QType (MQCFIN)
- Queue type (parameter identifier: MQIA_Q_TYPE).
The value can be:
- MQQT_ALIAS
- Alias queue definition.
- MQQT_CLUSTER
- Cluster queue definition.
- MQQT_LOCAL
- Local queue.
- MQQT_REMOTE
- Local definition of a remote queue.
- MQQT_MODEL
- Model queue definition.
- QueueAccounting (MQCFIN)
- Controls the collection of accounting (thread-level and queue-level accounting) data (parameter
identifier: MQIA_ACCOUNTING_Q).
The value can be:
- MQMON_Q_MGR
- The collection of accounting data for the queue is performed based upon the setting of the QueueAccounting parameter on the queue manager.
- MQMON_OFF
- Do not collect accounting data for the queue.
- MQMON_ON
- Collect accounting data for the queue.
- QueueMonitoring (MQCFIN)
- Online monitoring data collection (parameter identifier: MQIA_MONITORING_Q).
The value can be:
- MQMON_OFF
- Online monitoring data collection is turned off for this queue.
- MQMON_Q_MGR
- The value of the queue manager's QueueMonitoring parameter is inherited by the queue.
- MQMON_LOW
- Online monitoring data collection is turned on, with a low rate of data collection, for this queue unless QueueMonitoring for the queue manager is MQMON_NONE.
- MQMON_MEDIUM
- Online monitoring data collection is turned on, with a moderate rate of data collection, for this queue unless QueueMonitoring for the queue manager is MQMON_NONE.
- MQMON_HIGH
- Online monitoring data collection is turned on, with a high rate of data collection, for this queue unless QueueMonitoring for the queue manager is MQMON_NONE.
- QueueStatistics (MQCFIN)
- Controls the collection of statistics data (parameter identifier:
MQIA_STATISTICS_Q).
The value can be:
- MQMON_Q_MGR
- The collection of statistics data for the queue is performed based upon the setting of the QueueStatistics parameter on the queue manager.
- MQMON_OFF
- Do not collect statistics data for the queue.
- MQMON_ON
- Collect statistics data for the queue unless QueueStatistics for the queue manager is MQMON_NONE.
This parameter is supported only on Multiplatforms.
- RemoteQMgrName (MQCFST)
- Name of remote queue manager (parameter identifier: MQCA_REMOTE_Q_MGR_NAME).
The maximum length of the string is MQ_Q_MGR_NAME_LENGTH.
- RemoteQName (MQCFST)
- Name of remote queue as known locally on the remote queue manager (parameter identifier:
MQCA_REMOTE_Q_NAME).
The maximum length of the string is MQ_Q_NAME_LENGTH.
- RetentionInterval (MQCFIN)
- Retention interval (parameter identifier: MQIA_RETENTION_INTERVAL).
- Scope (MQCFIN)
- Scope of the queue definition (parameter identifier: MQIA_SCOPE).
The value can be:
- MQSCO_Q_MGR
- Queue manager scope.
- MQSCO_CELL
- Cell scope.
This parameter is not valid on IBM® i or z/OS.
- Shareability (MQCFIN)
- The queue can be shared, or not: (parameter identifier: MQIA_SHAREABILITY).
The value can be:
- MQQA_SHAREABLE
- Queue is shareable.
- MQQA_NOT_SHAREABLE
- Queue is not shareable.
- StorageClass (MQCFST)
- Storage class (parameter identifier: MQCA_STORAGE_CLASS). This parameter
applies to z/OS only.
Specifies the name of the storage class.
The maximum length of the string is MQ_STORAGE_CLASS_LENGTH.
- TpipeNames (MQCFSL)
- TPIPE names (parameter identifier: MQCA_TPIPE_NAME). This parameter applies to
local queues on z/OS only.
Specifies the TPIPE names used for communication with OTMA via the IBM MQ IMS bridge, if the bridge is active.
The maximum length of the string is MQ_TPIPE_NAME_LENGTH.
- TriggerControl (MQCFIN)
- Trigger control (parameter identifier: MQIA_TRIGGER_CONTROL).
The value can be:
- MQTC_OFF
- Trigger messages not required.
- MQTC_ON
- Trigger messages required.
- TriggerData (MQCFST)
- Trigger data (parameter identifier: MQCA_TRIGGER_DATA).
The maximum length of the string is MQ_TRIGGER_DATA_LENGTH.
- TriggerDepth (MQCFIN)
- Trigger depth (parameter identifier: MQIA_TRIGGER_DEPTH).
- TriggerMsgPriority (MQCFIN)
- Threshold message priority for triggers (parameter identifier: MQIA_TRIGGER_MSG_PRIORITY).
- TriggerType (MQCFIN)
- Trigger type (parameter identifier: MQIA_TRIGGER_TYPE).
The value can be:
- MQTT_NONE
- No trigger messages.
- MQTT_FIRST
- Trigger message when queue depth goes from 0 to 1.
- MQTT_EVERY
- Trigger message for every message.
- MQTT_DEPTH
- Trigger message when depth threshold exceeded.
- Usage (MQCFIN)
- Usage (parameter identifier: MQIA_USAGE).
The value can be:
- MQUS_NORMAL
- Normal usage.
- MQUS_TRANSMISSION
- Transmission queue.
- XmitQName (MQCFST)
- Transmission queue name (parameter identifier: MQCA_XMIT_Q_NAME).
The maximum length of the string is MQ_Q_NAME_LENGTH.