Inquire Queue Manager
The Inquire Queue Manager ( MQCMD_INQUIRE_Q_MGR ) command inquires about the attributes of a queue manager.
Optional parameters
- CommandScope (MQCFST)
- Command scope (parameter identifier: MQCACF_COMMAND_SCOPE). This parameter
applies to z/OS only.
Specifies how the command is processed when the queue manager is a member of a queue sharing group. We can specify one of the following values:
- Blank (or omit the parameter altogether). The command is processed on the queue manager on which it was entered.
- A queue manager name. The command is processed on the queue manager you specify, providing it is active within the queue sharing group. If you specify a queue manager name other than the queue manager on which it was entered, we must be using a queue sharing group environment. The command server must be enabled.
- An asterisk
*
. The command is processed on the local queue manager and is also passed to every active queue manager in the queue sharing group.
The maximum length is MQ_QSG_NAME_LENGTH.
We cannot use CommandScope as a parameter to filter on.
- QMgrAttrs (MQCFIL)
- Queue manager attributes (parameter identifier: MQIACF_Q_MGR_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 values:
- MQCA_ALTERATION_DATE
- Date at which the definition was last altered.
- MQCA_ALTERATION_TIME
- Time at which the definition was last altered.
- MQCA_CERT_LABEL
- Queue manager certificate label.
- MQCA_CHANNEL_AUTO_DEF_EXIT
- Automatic channel definition exit name. MQCA_CHANNEL_AUTO_DEF_EXIT is not valid on z/OS.
- MQCA_CLUSTER_WORKLOAD_DATA
- Data passed to the cluster workload exit.
- MQCA_CLUSTER_WORKLOAD_EXIT
- Name of the cluster workload exit.
- MQCA_COMMAND_INPUT_Q_NAME
- System command input queue name.
- MQCA_CONN_AUTH
- Name of the authentication information object that is used to provide the location of user ID and password authentication.
- MQCA_CREATION_DATE
- Queue manager creation date.
- MQCA_CREATION_TIME
- Queue manager creation time.
- MQCA_CUSTOM
- The custom attribute for new features.
- MQCA_DEAD_LETTER_Q_NAME
- Name of dead-letter queue.
- MQCA_DEF_XMIT_Q_NAME
- Default transmission queue name.
- MQCA_DNS_GROUP
- The name of the group that the TCP listener handling inbound transmissions for the queue sharing group must join when using Workload Manager for Dynamic Domain Name Services support (DDNS). MQCA_DNS_GROUP is valid on z/OS only.
- MQCA_IGQ_USER_ID
- Intra-group queuing user identifier. This parameter is valid on z/OS only.
- MQCA_LU_GROUP_NAME
- Generic LU name for the LU 6.2 listener. MQCA_LU_GROUP_NAME is valid on z/OS only.
- MQCA_LU_NAME
- LU name to use for outbound LU 6.2 transmissions. MQCA_LU_NAME is valid on z/OS only.
- MQCA_LU62_ARM_SUFFIX
- APPCPM suffix. MQCA_LU62_ARM_SUFFIX is valid on z/OS only.
- MQCA_PARENT
- The name of the hierarchically connected queue manager that is nominated as the parent of this queue manager.
- MQCA_Q_MGR_DESC
- Queue manager description.
- MQCA_Q_MGR_IDENTIFIER
- Internally generated unique queue manager name.
- MQCA_Q_MGR_NAME
- Name of local queue manager.
- MQCA_QSG_CERT_LABEL
- Queue sharing group certificate label. This parameter attribute is valid on z/OS only.
- MQCA_QSG_NAME
- Queue sharing group name. This parameter attribute is valid on z/OS only.
- MQCA_REPOSITORY_NAME
- Cluster name for the queue manager repository.
- MQCA_REPOSITORY_NAMELIST
- Name of the list of clusters for which the queue manager is providing a repository manager service.
- MQCA_SSL_CRL_NAMELIST
- TLS certificate revocation location namelist.
- MQCA_SSL_CRYPTO_HARDWARE
- Parameters to configure the TLS cryptographic hardware. This parameter is supported only on UNIX, Linux, and Windows.
- MQCA_SSL_KEY_REPOSITORY
- Location and name of the TLS key repository.
- MQCA_TCP_NAME
- Name of the TCP/IP system that we are using. MQCA_TCP_NAME is valid on z/OS only.
- MQCA_VERSION
- The version of the IBM MQ installation, the queue manager is associated with. The version has the format VVRRMMFF:
- MQIA_ACCOUNTING_CONN_OVERRIDE
- Specifies whether the settings of the MQIAccounting and QueueAccounting queue manager parameters can be overridden. MQIA_ACCOUNTING_CONN_OVERRIDE is valid only on UNIX, Linux, and Windows.
- MQIA_ACCOUNTING_INTERVAL
- Intermediate accounting data collection interval. MQIA_ACCOUNTING_INTERVAL is valid only on UNIX, Linux, and Windows.
- MQIA_ACCOUNTING_MQI
- Specifies whether accounting information is to be collected for MQI data. MQIA_ACCOUNTING_MQI is valid only on UNIX, Linux, and Windows.
- MQIA_ACCOUNTING_Q
- Accounting data collection for queues.
- MQIA_ACTIVE_CHANNELS
- Maximum number of channels that can be active at any time. MQIA_ACTIVE_CHANNELS is valid on z/OS only.
- MQIA_ACTIVITY_CONN_OVERRIDE
- Specifies whether the value of application activity trace can be overridden.
- MQIA_ACTIVITY_RECORDING
- Specifies whether activity reports can be generated.
- MQIA_ACTIVITY_TRACE
- Specifies whether application activity trace reports can be generated.
- MQIA_ADOPTNEWMCA_CHECK
- Elements checked to determine whether an MCA must be adopted when a new inbound channel is detected with the same name as an MCA that is already active. MQIA_ADOPTNEWMCA_CHECK is valid on z/OS only.
- MQIA_ADOPTNEWMCA_TYPE
- Specifies whether an orphaned instance of an MCA must be restarted automatically when a new inbound channel request matching the AdoptNewMCACheck parameter is detected. MQIA_ADOPTNEWMCA_TYPE is valid on z/OS only.
- MQIA_ADVANCED_CAPABILITY
- Specifies whether IBM MQ Advanced extended capabilities are available for a queue manager.
- MQIA_AMQP_CAPABILITY
- Specifies whether AMQP capabilities are available for a queue manager.
- MQIA_AUTHORITY_EVENT
- Control attribute for authority events.
- MQIA_BRIDGE_EVENT
- Control attribute for IMS bridge events. MQIA_BRIDGE_EVENT is valid only on z/OS.
- MQIA_CERT_VAL_POLICY
- Specifies which TLS certificate validation policy is used to validate digital certificates received from remote partner systems. This attribute controls how strictly the certificate chain validation conforms to industry security standards. MQIA_CERT_VAL_POLICY is valid only on UNIX, Linux, and Windows. For more information, see Certificate validation policies in IBM MQ.
- MQIA_CHANNEL_AUTO_DEF
- Control attribute for automatic channel definition. MQIA_CHANNEL_AUTO_DEF is not valid on z/OS.
- MQIA_CHANNEL_AUTO_DEF_EVENT
- Control attribute for automatic channel definition events. MQIA_CHANNEL_AUTO_DEF_EVENT is not valid on z/OS.
- MQIA_CHANNEL_EVENT
- Control attribute for channel events.
- MQIA_CHINIT_ADAPTERS
- Number of adapter subtasks to use for processing IBM MQ calls. MQIA_CHINIT_ADAPTERS is valid on z/OS only.
- MQIA_CHINIT_CONTROL
- Start channel initiator automatically when queue manager starts.
- MQIA_CHINIT_DISPATCHERS
- Number of dispatchers to use for the channel initiator. MQIA_CHINIT_DISPATCHERS is valid on z/OS only.
- MQIA_CHINIT_SERVICE_PARM
- Reserved for use by IBM. MQIA_CHINIT_SERVICE_PARM is valid only on z/OS.
- MQIA_CHINIT_TRACE_AUTO_START
- Specifies whether the channel initiator trace must start automatically. MQIA_CHINIT_TRACE_AUTO_START is valid on z/OS only.
- MQIA_CHINIT_TRACE_TABLE_SIZE
- Size, in megabytes, of the trace data space of the channel initiator. MQIA_CHINIT_TRACE_TABLE_SIZE is valid on z/OS only.
- MQIA_CHLAUTH_RECORDS
- Control attribute for checking of channel authentication records.
- MQIA_CLUSTER_WORKLOAD_LENGTH
- Maximum length of the message passed to the cluster workload exit.
- MQIA_CLWL_MRU_CHANNELS
- Cluster workload most recently used channels.
- MQIA_CLWL_USEQ
- Cluster workload remote queue use.
- MQIA_CMD_SERVER_CONTROL
- Start command server automatically when queue manager starts.
- MQIA_CODED_CHAR_SET_ID
- Coded character set identifier.
- MQIA_COMMAND_EVENT
- Control attribute for command events.
- MQIA_COMMAND_LEVEL
- Command level supported by queue manager.
- MQIA_CONFIGURATION_EVENT
- Control attribute for configuration events.
- MQIA_CPI_LEVEL
- Reserved for use by IBM.
- MQIA_DEF_CLUSTER_XMIT_Q_TYPE
- Default transmission queue type to be used for cluster-sender channels.
- MQIA_DIST_LISTS
- Distribution list support. This parameter is not valid on z/OS.
- MQIA_DNS_WLM
- Specifies whether the TCP listener that handles inbound transmissions for the queue sharing group must register with Workload Manager (WLM) for DDNS. MQIA_DNS_WLM is valid on z/OS only.
- MQIA_EXPIRY_INTERVAL
- Expiry interval. This parameter is valid on z/OS only.
- MQIA_GROUP_UR
- Control attribute for whether transactional applications can connect with a GROUP unit of recovery disposition. This parameter is valid only on z/OS.
- MQIA_IGQ_PUT_AUTHORITY
- Intra-group queuing put authority. This parameter is valid on z/OS only.
- MQIA_INHIBIT_EVENT
- Control attribute for inhibit events.
- MQIA_INTRA_GROUP_queuing
- Intra-group queuing support. This parameter is valid on z/OS only.
- MQIA_IP_ADDRESS_VERSION
- IP address version selector.
- MQIA_LISTENER_TIMER
- Listener restart interval. MQIA_LISTENER_TIMER is valid on z/OS only.
- MQIA_LOCAL_EVENT
- Control attribute for local events.
- MQIA_LOGGER_EVENT
- Control attribute for recovery log events.
- MQIA_LU62_CHANNELS
- Maximum number of LU 6.2 channels. MQIA_LU62_CHANNELS is valid on z/OS only.
- MQIA_MSG_MARK_BROWSE_INTERVAL
- Interval for which messages that were browsed, remain marked.
- MQIA_MAX_CHANNELS
- Maximum number of channels that can be current. MQIA_MAX_CHANNELS is valid on z/OS only.
- MQIA_MAX_HANDLES
- Maximum number of handles.
- MQIA_MAX_MSG_LENGTH
- Maximum message length.
- MQIA_MAX_PRIORITY
- Maximum priority.
- MQIA_MAX_PROPERTIES_LENGTH
- Maximum properties length.
- MQIA_MAX_UNCOMMITTED_MSGS
- Maximum number of uncommitted messages within a unit of work.
- MQIA_MEDIA_IMAGE_INTERVAL
- The target frequency with which the queue manager automatically writes media images.
- MQIA_MEDIA_IMAGE_LOG_LENGTH
- The target size of the recovery log.
- MQIA_MEDIA_IMAGE_RECOVER_OBJ
- Specifies the recoverable objects from a media image, if linear logging is being used.
- MQIA_MEDIA_IMAGE_RECOVER_Q
- Specifies whether local and permanent dynamic queues defined with ImageRecoverQueue set to MQIMGRCOV_AS_Q_MGR are recoverable from a media image.
- MQIA_MEDIA_IMAGE_SCHEDULING
- Whether the queue manager automatically writes media images.
- MQIA_MONITORING_AUTO_CLUSSDR
- Default value of the ChannelMonitoring attribute of automatically defined cluster-sender channels.
- MQIA_MONITORING_CHANNEL
- Specifies whether channel monitoring is enabled.
- MQIA_MONITORING_Q
- Specifies whether queue monitoring is enabled.
- MQIA_OUTBOUND_PORT_MAX
- Maximum value in the range for the binding of outgoing channels. MQIA_OUTBOUND_PORT_MAX is valid on z/OS only.
- MQIA_OUTBOUND_PORT_MIN
- Minimum value in the range for the binding of outgoing channels. MQIA_OUTBOUND_PORT_MIN is valid on z/OS only.
- MQIA_PERFORMANCE_EVENT
- Control attribute for performance events.
- MQIA_PLATFORM
- Platform on which the queue manager resides.
- MQIA_PROT_POLICY_CAPABILITY
- Specifies whether Advanced Message Security is installed for the version of IBM MQ that the queue manager is running.
- MQIA_PUBSUB_CLUSTER
- Controls whether this queue manager participates in the publish/subscribe clustering.
- MQIA_PUBSUB_MAXMSG_RETRY_COUNT
- The number of retries when processing (under sync point) a failed command message
- MQIA_PUBSUB_MODE
- Inquires if the publish/subscribe engine and the queued publish/subscribe interface are running, which allow applications to publish/subscribe by using the application programming interface and the queues that are being monitored by the queued publish/subscribe interface.
- MQIA_PUBSUB_NP_MSG
- Specifies whether to discard (or keep) an undelivered input message.
- MQIA_PUBSUB_NP_RESP
- The behavior of undelivered response messages.
- MQIA_PUBSUB_SYNC_PT
- Specifies whether only persistent (or all) messages must be processed under sync point.
- MQIA_QMGR_CFCONLOS
- Specifies action to be taken when the queue manager loses connectivity to the administration structure, or any CF structure with CFCONLOS set to ASQMGR. MQIA_QMGR_CFCONLOS is valid on z/OS only.
- MQIA_RECEIVE_TIMEOUT
- How long a TCP/IP channel waits to receive data from its partner. MQIA_RECEIVE_TIMEOUT is valid on z/OS only.
- MQIA_RECEIVE_TIMEOUT_MIN
- Minimum length of time that a TCP/IP channel waits to receive data from its partner . MQIA_RECEIVE_TIMEOUT_MIN is valid on z/OS only.
- MQIA_RECEIVE_TIMEOUT_TYPE
- Qualifier to apply to the ReceiveTimeout parameter. MQIA_RECEIVE_TIMEOUT_TYPE is valid on z/OS only.
- MQIA_REMOTE_EVENT
- Control attribute for remote events.
- MQIA_SECURITY_CASE
- Specifies whether the queue manager supports security profile names either in mixed case, or in uppercase only. MQIA_SECURITY_CASE is valid only on z/OS.
- MQIA_SHARED_Q_Q_MGR_NAME
- When a queue manager makes an MQOPEN call for a shared queue and the queue manager that is specified in the ObjectQmgrName parameter of the MQOPEN call is in the same queue sharing group as the processing queue manager, the SQQMNAME attribute specifies whether the ObjectQmgrName is used or whether the processing queue manager opens the shared queue directly. MQIA_SHARED_Q_Q_MGR_NAME is valid only on z/OS.
- MQIA_SSL_EVENT
- Control attribute for TLS events.
- MQIA_SSL_FIPS_REQUIRED
- Specifies whether only FIPS-certified algorithms are to be used if cryptography is executed in IBM MQ rather then in the cryptographic hardware itself.
- MQIA_SSL_RESET_COUNT
- TLS key reset count.
- MQIA_SSL_TASKS
- TLS tasks. This parameter is valid on z/OS only.
- MQIA_START_STOP_EVENT
- Control attribute for start stop events.
- MQIA_STATISTICS_AUTO_CLUSSDR
- Specifies whether statistics data is to be collected for auto-defined cluster-sender channels and, if so, the rate of data collection.
- MQIA_STATISTICS_CHANNEL
- Specifies whether statistics monitoring data is to be collected for channels and, if so, the rate of data collection.
- MQIA_STATISTICS_INTERVAL
- Statistics data collection interval. MQIA_STATISTICS_INTERVAL is valid only on UNIX, Linux, and Windows.
- MQIA_STATISTICS_MQI
- Specifies whether statistics monitoring data is to be collected for the queue manager. MQIA_STATISTICS_MQI is valid only on UNIX, Linux, and Windows.
- MQIA_STATISTICS_Q
- Specifies whether statistics monitoring data is to be collected for queues. MQIA_STATISTICS_Q is valid only on UNIX, Linux, and Windows.
- MQIA_SUITE_B_STRENGTH
- Specifies whether Suite B-compliant cryptography is used and the level of strength employed. For more information about Suite B configuration and its effect on TLS channels, see NSA Suite B Cryptography in IBM MQ .
- MQIA_SYNCPOINT
- Sync point availability.
- MQIA_TCP_CHANNELS
- Maximum number of channels that can be current, or clients that can be connected, that use the TCP/IP transmission protocol This is valid only on z/OS.
- MQIA_TCP_KEEP_ALIVE
- Specifies whether the TCP KEEPALIVE facility is to be used to check whether the other end of a connection is still available. MQIA_TCP_KEEP_ALIVE is valid only on z/OS.
- MQIA_TCP_STACK_TYPE
- Specifies whether the channel initiator can use only the TCP/IP address space specified in the TCPName parameter, or can optionally bind to any selected TCP/IP address. MQIA_TCP_STACK_TYPE is valid only on z/OS.
- MQIA_TRACE_ROUTE_RECORDING
- Specifies whether trace-route information can be recorded and reply messages generated.
- MQIA_TREE_LIFE_TIME
- The lifetime of non-administrative topics.
- MQIA_TRIGGER_INTERVAL
- Trigger interval.
- MQIA_XR_CAPABILITY
- Specifies whether telemetry commands are supported.
- MQIACF_Q_MGR_CLUSTER
- All clustering attributes. These attributes are:
- MQCA_CLUSTER_WORKLOAD_DATA
- MQCA_CLUSTER_WORKLOAD_EXIT
- MQCA_CHANNEL_AUTO_DEF_EXIT
- MQCA_REPOSITORY_NAME
- MQCA_REPOSITORY_NAMELIST
- MQIA_CLUSTER_WORKLOAD_LENGTH
- MQIA_CLWL_MRU_CHANNELS
- MQIA_CLWL_USEQ
- MQIA_MONITORING_AUTO_CLUSSDR
- MQCA_Q_MGR_IDENTIFIER
- MQIACF_Q_MGR_DQM
- All distributed queuing attributes. These attributes are:
- MQCA_CERT_LABEL
- MQCA_CHANNEL_AUTO_DEF_EXIT
- MQCA_DEAD_LETTER_Q_NAME
- MQCA_DEF_XMIT_Q_NAME
- MQCA_DNS_GROUP
- MQCA_IGQ_USER_ID
- MQCA_LU_GROUP_NAME
- MQCA_LU_NAME
- MQCA_LU62_ARM_SUFFIX
- MQCA_Q_MGR_IDENTIFIER
- MQCA_QSG_CERT_LABEL
- MQCA_SSL_CRL_NAMELIST
- MQCA_SSL_CRYPTO_HARDWARE
- MQCA_SSL_KEY_REPOSITORY
- MQCA_TCP_NAME
- MQIA_ACTIVE_CHANNELS
- MQIA_ADOPTNEWMCA_CHECK
- MQIA_ADOPTNEWMCA_TYPE
- MQIA_CERT_VAL_POLICY
- MQIA_CHANNEL_AUTO_DEF
- MQIA_CHANNEL_AUTO_DEF_EVENT
- MQIA_CHANNEL_EVENT
- MQIA_CHINIT_ADAPTERS
- MQIA_CHINIT_CONTROL
- MQIA_CHINIT_DISPATCHERS
- MQIA_CHINIT_SERVICE_PARM
- MQIA_CHINIT_TRACE_AUTO_START
- MQIA_CHINIT_TRACE_TABLE_SIZE
- MQIA_CHLAUTH_RECORDS
- MQIA_INTRA_GROUP_queuing
- MQIA_IGQ_PUT_AUTHORITY
- MQIA_IP_ADDRESS_VERSION
- MQIA_LISTENER_TIMER
- MQIA_LU62_CHANNELS
- MQIA_MAX_CHANNELS
- MQIA_MONITORING_CHANNEL
- MQIA_OUTBOUND_PORT_MAX
- MQIA_OUTBOUND_PORT_MIN
- MQIA_RECEIVE_TIMEOUT
- MQIA_RECEIVE_TIMEOUT_MIN
- MQIA_RECEIVE_TIMEOUT_TYPE
- MQIA_SSL_EVENT
- MQIA_SSL_FIPS_REQUIRED
- MQIA_SSL_RESET_COUNT
- MQIA_SSL_TASKS
- MQIA_STATISTICS_AUTO_CLUSSDR
- MQIA_TCP_CHANNELS
- MQIA_TCP_KEEP_ALIVE
- MQIA_TCP_STACK_TYPE
- MQIACF_Q_MGR_EVENT
- All event control attributes. These attributes are:
- MQIA_AUTHORITY_EVENT
- MQIA_BRIDGE_EVENT
- MQIA_CHANNEL_EVENT
- MQIA_COMMAND_EVENT
- MQIA_CONFIGURATION_EVENT
- MQIA_INHIBIT_EVENT
- MQIA_LOCAL_EVENT
- MQIA_LOGGER_EVENT
- MQIA_PERFORMANCE_EVENT
- MQIA_REMOTE_EVENT
- MQIA_SSL_EVENT
- MQIA_START_STOP_EVENT
- MQIACF_Q_MGR_PUBSUB
- All queue manager publish/subscribe attributes. These attributes are:
- MQCA_PARENT
- MQIA_PUBSUB_MAXMSG_RETRY_COUNT
- MQIA_PUBSUB_MODE
- MQIA_PUBSUB_NP_MSG
- MQIA_PUBSUB_NP_RESP
- MQIA_PUBSUB_SYNC_PT
- MQIA_TREE_LIFE_TIME
- MQIACF_Q_MGR_SYSTEM
- All queue manager system attributes. These attributes are:
- MQCA_ALTERATION_DATE
- MQCA_ALTERATION_TIME
- MQCA_COMMAND_INPUT_Q_NAME
- MQCA_CONN_AUTH
- MQCA_CREATION_DATE
- MQCA_CREATION_TIME
- MQCA_CUSTOM
- MQCA_DEAD_LETTER_Q_NAME
- MQCA_Q_MGR_DESC
- MQCA_Q_MGR_NAME
- MQCA_QSG_NAME
- MQCA_VERSION
- MQIA_ACCOUNTING_CONN_OVERRIDE
- MQIA_ACCOUNTING_INTERVAL
- MQIA_ACCOUNTING_MQI
- MQIA_ACCOUNTING_Q
- MQIA_ACTIVITY_CONN_OVERRIDE
- MQIA_ACTIVITY_RECORDING
- MQIA_ACTIVITY_TRACE
- MQIA_ADVANCED_CAPABILITY
- MQIA_CMD_SERVER_CONTROL
- MQIA_CODED_CHAR_SET_ID
- MQIA_COMMAND_LEVEL
- MQIA_CPI_LEVEL
- MQIA_DIST_LISTS
- MQIA_EXPIRY_INTERVAL
- MQIA_GROUP_UR
- MQIA_MAX_HANDLES
- MQIA_MAX_MSG_LENGTH
- MQIA_MAX_PRIORITY
- MQIA_MAX_PROPERTIES_LENGTH
- MQIA_MAX_UNCOMMITTED_MSGS
- MQIA_MEDIA_IMAGE_INTERVAL
- MQIA_MEDIA_IMAGE_LOG_LENGTH
- MQIA_MEDIA_IMAGE_RECOVER_OBJ
- MQIA_MEDIA_IMAGE_RECOVER_Q
- MQIA_MEDIA_IMAGE_SCHEDULING
- MQIA_MONITORING_Q
- MQIA_MSG_MARK_BROWSE_INTERVAL
- MQIA_PROT_POLICY_CAPABILITY
- MQIA_QMGR_CFCONLOS
- MQIA_SECURITY_CASE
- MQIA_PLATFORM
- MQIA_SHARED_Q_Q_MGR_NAME
- MQIA_STATISTICS_INTERVAL
- MQIA_STATISTICS_MQI
- MQIA_STATISTICS_Q
- MQIA_SYNCPOINT
- MQIA_TRACE_ROUTE_RECORDING
- MQIA_TRIGGER_INTERVAL
- MQIA_XR_CAPABILITY
Parent topic: Definitions of the Programmable Command Formats