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

    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_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. This parameter is valid as follows:

      • On z/OS from IBM MQ Version 9.0.4.
      • On other platforms from IBM MQ Version 9.0.5.

      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_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_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_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_COMMAND_INPUT_Q_NAME
      • MQCA_CUSTOM
      • MQCA_DEAD_LETTER_Q_NAME
      • MQCA_Q_MGR_NAME
      • MQCA_QSG_NAME
      • MQCA_VERSION
      • MQIA_ACCOUNTING_CONN_OVERRIDE
      • MQIA_ACCOUNTING_INTERVAL
      • MQIA_ACCOUNTING_Q
      • MQIA_ACTIVITY_CONN_OVERRIDE
      • MQIA_ACTIVITY_RECORDING
      • MQIA_ACTIVITY_TRACE
      • MQCA_ALTERATION_DATE
      • MQCA_ALTERATION_TIME
      • MQIA_CMD_SERVER_CONTROL
      • MQIA_CODED_CHAR_SET_ID
      • MQIA_COMMAND_LEVEL
      • MQIA_CPI_LEVEL
      • MQIA_DIST_LISTS
      • MQIA_EXPIRY_INTERVAL
      • MQIA_MAX_HANDLES
      • MQIA_MAX_MSG_LENGTH
      • MQIA_MAX_PRIORITY
      • MQIA_MAX_PROPERTIES_LENGTH
      • MQIA_MAX_UNCOMMITTED_MSGS
      • MQIA_MONITORING_Q
      • 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