Previous Topic: MQ SET—Set AttributesNext Topic: MQ CLOSE—Close Queue


MQ INQUIRE—Inquire Attributes

The ADDRESS MQ INQUIRE command inquires which attributes are set for the queue or queue manager.

Calling this command creates the compound variables, where you can specify a stem variable or use the default stem, and the tail is the attribute name.

This command has the following format:

ADDRESS MQ INQUIRE
   {ATTRIBUTES(attributes)}
   [STEM(varSTEM)]
   {CONHANDLE(varHCONN)}
   {OBJHANDLE(varHOBJ)}
ATTRIBUTES(attributes)

Specifies which attributes to get. You can specify up to 16 attributes.

There are six types of attributes:

Character attributes for the queue:
  • BACKOUT_REQ_Q_NAME

    Returns the excessive backout requeue name.

  • BASE_Q_NAME

    Returns the queue name to which the alias resolves.

  • CF_STRUC_NAME

    Returns the coupling-facility structure name.

  • CLUSTER_NAME

    Returns the cluster name.

  • CLUSTER_NAMELIST

    Returns the cluster name list.

  • CREATION_DATE

    Returns the queue creation date.

  • CREATION_TIME

    Returns the queue creation time.

  • INITIATION_Q_NAME

    Returns the initiation queue name.

  • PROCESS_NAME

    Returns the process definition name.

  • Q_DESC

    Returns the queue description.

  • Q_NAME

    Returns the queue name.

  • REMOTE_Q_MGR_NAME

    Returns the remote queue manager name.

  • REMOTE_Q_NAME

    Returns the remote queue name as known on the remote queue manager.

  • STORAGE_CLASS

    Returns the storage class name.

  • TRIGGER_DATA

    Returns the trigger data.

  • XMIT_Q_NAME

    Returns the transmission queue name.

Character attributes for the queue manager:
  • CHANNEL_AUTO_DEF_EXIT

    Returns the automatic channel definition exit name.

  • CLUSTER_WORKLOAD_DATA

    Returns the data passed to cluster workload exit.

  • CLUSTER_WORKLOAD_EXIT

    Returns the cluster workload exit name.

  • COMMAND_INPUT_Q_NAME

    Returns the system command input queue name.

  • DEAD_LETTER_Q_NAME

    Returns the dead-letter queue name.

  • DEF_XMIT_Q_NAME

    Returns the default transmission queue name.

  • DNS_GROUP

    Returns the TCP listener group name.

  • IGQ_USER_ID

    Returns the intra-group queuing user identifier.

  • LU_GROUP_NAME

    Returns the LU 6.2 listener generic LU name.

  • LU_NAME

    Returns the LU name to use for outbound LU 6.2 transmissions.

  • LU62_ARM_SUFFIX

    Returns the suffix of the SYS1.PARMLIB member APPCPMxx.

  • Q_MGR_DESC

    Returns the queue manager description.

  • Q_MGR_IDENTIFIER

    Returns the queue-manager identifier.

  • Q_MGR_NAME

    Returns the local queue manager name.

  • QSG_NAME

    Returns the queue-sharing group name.

  • REPOSITORY_NAME

    Returns the cluster name for which queue manager provides repository services.

  • REPOSITORY_NAMELIST

    Returns the name of the namelist object containing the names of clusters for which queue manager provides repository services.

  • TCP_NAME

    Returns the name of the TCP/IP system that you are using.

Character attributes common for queue and queue manager:
  • ALTERATION_DATE

    Returns the date of most-recent alteration.

  • ALTERATION_TIME

    Returns the time of most-recent alteration.

Integer attributes for the queue:
  • BACKOUT_THRESHOLD

    Returns the backout threshold.

  • CLWL_Q_PRIORITY

    Returns the priority of the queue.

  • CLWL_Q_RANK

    Returns the rank of the queue.

  • CLWL_USEQ

    Returns the remote queues to be used.

  • CURRENT_Q_DEPTH

    Returns the number of messages on queue.

  • DEF_BIND

    Returns the default binding.

  • DEF_INPUT_OPEN_OPTION

    Returns the default open-for-input option.

  • DEF_PERSISTENCE

    Returns the default message persistence.

  • DEF_PRIORITY

    Returns the default message priority.

  • DEFINITION_TYPE

    Returns the queue definition type.

  • HARDEN_GET_BACKOUT

    Returns whether to harden the backout count.

  • INDEX_TYPE

    Returns the type of index maintained for queue.

  • INHIBIT_GET

    Returns whether get operations are allowed.

  • INHIBIT_PUT

    Returns whether put operations are allowed.

  • MAX_MSG_LENGTH

    Returns the maximum message length.

  • MAX_Q_DEPTH

    Returns the maximum number of messages allowed on queue.

  • MSG_DELIVERY_SEQUENCE

    Returns whether message priority is relevant.

  • NPM_CLASS

    Returns the level of reliability for nonpersistent messages.

  • OPEN_INPUT_COUNT

    Returns the number of MQOPEN calls that have the queue open for input.

  • OPEN_OUTPUT_COUNT

    Returns the number of MQOPEN calls that have the queue open for output.

  • Q_TYPE

    Returns the queue type.

  • QSG_DISP

    Returns the queue-sharing group disposition.

  • RETENTION_INTERVAL

    Returns the queue retention interval.

  • SHAREABILITY

    Returns whether the queue can be shared for input.

  • TRIGGER_CONTROL

    Returns the trigger control.

  • TRIGGER_DEPTH

    Returns the trigger depth.

  • TRIGGER_MSG_PRIORITY

    Returns the threshold message priority for triggers.

    Valid values: 0 - MaxPriority

MaxPriority

Maximum message priority supported by the queue manager.

Lowest: 0

Highest: MaxPriority

  • TRIGGER_TYPE

    Returns the trigger type.

  • USAGE

    Returns the usage.

Integer attributes for the queue manager:
  • ACTIVE_CHANNELS

    Returns the maximum number of active channels.

  • ADOPTNEWMCA_CHECK

    Returns whether to adopt the new MCA when a new inbound channel is detected with the same name as the active MCA.

  • ADOPTNEWMCA_TYPE

    Returns whether to automatically restart an orphaned MCA instance of a given channel type when a new inbound channel request matches the AdoptNewMCACheck parameters.

  • BRIDGE_EVENT

    Returns the control attribute for IMS bridge events.

  • CHANNEL_EVENT

    Returns the control attribute for channel events.

  • CHINIT_ADAPTERS

    Returns the number of adapter subtasks to use for processing WebSphere MQ calls.

  • CHINIT_DISPATCHERS

    Returns the number of dispatchers to use for the channel initiator.

  • CHINIT_TRACE_AUTO_START

    Returns whether to start channel initiator trace automatically.

  • CHINIT_TRACE_TABLE_SIZE

    Returns the size of the channel initiator's trace data space (in MB).

  • CLUSTER_WORKLOAD_LENGTH

    Returns the cluster workload length.

  • CLWL_MRU_CHANNELS

    Returns the channel MRU.

  • CODED_CHAR_SET_ID

    Returns the coded character set identifier.

  • COMMAND_EVENT

    Returns the control attribute for command events.

  • COMMAND_LEVEL

    Returns the command level supported by queue manager.

  • DNS_WLM

    Returns whether the TCP listener registers with Workload Manager for Dynamic Domain Name Services.

  • EXPIRY_INTERVAL

    Returns the interval between scans for expired messages.

  • IGQ_PUT_AUTHORITY

    Returns the intra-group queuing put authority.

  • INTRA_GROUP_QUEUING

    Returns the intra-group queuing support.

  • LISTENER_TIMER

    Returns the time interval in seconds between WebSphere MQ attempts to restart the listener (in case of an APPC or TCP/IP failure).

  • LU62_CHANNELS

    Returns the maximum number of channels that can be current, or clients that can be connected.

  • MAX_CHANNELS

    Returns the maximum number of channels that can be current.

  • MAX_HANDLES

    Returns the maximum number of handles.

  • MAX_MSG_LENGTH

    Returns the maximum message length.

  • MAX_PRIORITY

    Returns the maximum priority.

  • MAX_UNCOMMITTED_MSGS

    Returns the maximum number of uncommitted messages within a unit of work.

  • OUTBOUND_PORT_MAX with OUTBOUND_PORT_MIN

    Defines range of port numbers to use when binding outgoing channels.

  • OUTBOUND_PORT_MIN with OUTBOUND_PORT_MAX

    Defines range of port numbers to use when binding outgoing channels.

  • PLATFORM

    Returns the platform on which the queue manager resides.

  • RECEIVE_TIMEOUT

    Returns approximately how long a TCP/IP channel waits to receive data.

  • RECEIVE_TIMEOUT_MIN

    Returns the minimum time that a TCP/IP channel waits to receive data.

  • RECEIVE_TIMEOUT_TYPE

    Returns approximately how long a TCP/IP channel waits to receive data.

  • SSL_EVENT

    Returns the control attribute for channel events.

  • SSL_RESET_COUNT

    Returns the SSL key reset count.

  • SYNCPOINT

    Returns the syncpoint availability.

  • TCP_CHANNELS

    Returns the maximum number of channels that can be current, or clients that can be connected.

  • TCP_KEEP_ALIVE

    Returns whether to use the TCP KEEPALIVE facility to check that the connection is still available.

  • TCP_STACK_TYPE

    Returns whether the channel initiator can use only the TCP/IP address space specified in TCPNAME, or can optionally bind to any selected TCP/IP address.

  • TRACE_ROUTE_RECORDING

    Controls recording of trace-route information.

  • TRIGGER_INTERVAL

    Returns the trigger interval.

Integer attributes for the queue and queue manager
  • CLWL_USEQ

    Use remote queues.

STEM(varSTEM)

(Optional) Defines the stem of the compound variable that stores the attributes. If omitted, MQ will be used.

This compound variable is created after the MQ INQUIRE command.

CONHANDLE(varHCONN)

Defines the variable name that stores the connection handle.

OBJHANDLE(varHOBJ)

Defines the variable name that stores the object handle.

Examples: MQ INQUIRE

This example of MQ INQUIRE has two attributes, alteration date and time, and omits the STEM.

address MQ "INQUIRE CONHANDLE(HCONN) OBJHANDLE(HOBJ)",  
           "ATTRIBUTES(ALTERATION_DATE ALTERATION_TIME)"
say MQ.ALTENATION_DATE 
say MQ.ALTENATION_TIME

This example of MQ INQUIRE has three attributes, TCP name, number of handles, and TCP channels. The STEM is omitted. This example is valid only if the object is queue manager (object opened with MQ OPEN command).

address MQ "INQUIRE CONHANDLE(HCONN) OBJHANDLE(HOBJ)",  
           "ATTRIBUTES(TCP_NAME MAX_HANDLES TCP_CHANNELS)"
say MQ.TCP_NAME 
say MQ.MAX_HANDLES
say MQ.TCP_CHANNELS