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. You 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, you 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.

You 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 you 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:

VV: Version

RR: Release

MM: Maintenance level

FF: Fix level

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