MQIA_* values" /> Selectors (MQLONGxSelectorCount) - input
Home

 

Selectors (MQLONGxSelectorCount) - input

This is an array of SelectorCount attribute selectors; each selector identifies an attribute (integer or character) whose value is required.

Each selector must be valid for the type of object that Hobj represents, otherwise the call fails with completion code MQCC_FAILED and reason code MQRC_SELECTOR_ERROR.

In the special case of queues:

We can specify selectors in any order. Attribute values that correspond to integer attribute selectors (MQIA_* selectors) are returned in IntAttrs in the same order in which these selectors occur in Selectors. Attribute values that correspond to character attribute selectors (MQCA_* selectors) are returned in CharAttrs in the same order in which those selectors occur. MQIA_* selectors can be interleaved with the MQCA_* selectors; only the relative order within each type is important.

Notes:

  1. The integer and character attribute selectors are allocated within two different ranges; the MQIA_* selectors reside within the range MQIA_FIRST through MQIA_LAST, and the MQCA_* selectors within the range MQCA_FIRST through MQCA_LAST.

    For each range, the constants MQIA_LAST_USED and MQCA_LAST_USED define the highest value that the queue manager will accept.

  2. If all of the MQIA_* selectors occur first, the same element numbers can be used to address corresponding elements in the Selectors and IntAttrs arrays.

  3. If the SelectorCount parameter is zero, Selectors is not referred to; in this case, the parameter address passed by programs written in C or System/390 assembler may be null.

The attributes that can be inquired are listed in the following tables. For the MQCA_* selectors, the constant that defines the length in bytes of the resulting string in CharAttrs is given in parentheses.

The tables that follow list the selectors, by object, in alphabetic order, as follows:

All selectors are supported on all WebSphere MQ V6.0 platforms, except where indicated in the Note column as follows:

Not z/OS

Supported on all platforms except z/OS

z/OS

Supported only on z/OS
Table 76. MQINQ attribute selectors for queues
Selector Description Note
MQCA_ALTERATION_DATE Date of most-recent alteration (MQ_DATE_LENGTH).
MQCA_ALTERATION_TIME Time of most-recent alteration (MQ_TIME_LENGTH).
MQCA_BACKOUT_REQ_Q_NAME Excessive backout requeue name (MQ_Q_NAME_LENGTH).
MQCA_BASE_Q_NAME Name of queue that alias resolves to (MQ_Q_NAME_LENGTH).
MQCA_CF_STRUC_NAME Coupling-facility structure name (MQ_CF_STRUC_NAME_LENGTH). z/OS
MQCA_CLUSTER_NAME Cluster name (MQ_CLUSTER_NAME_LENGTH).
MQCA_CLUSTER_NAMELIST Cluster namelist (MQ_NAMELIST_NAME_LENGTH).
MQCA_CREATION_DATE Queue creation date (MQ_CREATION_DATE_LENGTH).
MQCA_CREATION_TIME Queue creation time (MQ_CREATION_TIME_LENGTH).
MQCA_INITIATION_Q_NAME Initiation queue name (MQ_Q_NAME_LENGTH).
MQCA_PROCESS_NAME Name of process definition (MQ_PROCESS_NAME_LENGTH).
MQCA_Q_DESC Queue description (MQ_Q_DESC_LENGTH).
MQCA_Q_NAME Queue name (MQ_Q_NAME_LENGTH).
MQCA_REMOTE_Q_MGR_NAME Name of remote queue manager (MQ_Q_MGR_NAME_LENGTH).
MQCA_REMOTE_Q_NAME Name of remote queue as known on remote queue manager (MQ_Q_NAME_LENGTH).
MQCA_STORAGE_CLASS Name of storage class (MQ_STORAGE_CLASS_LENGTH). z/OS
MQCA_TRIGGER_DATA Trigger data (MQ_TRIGGER_DATA_LENGTH).
MQCA_XMIT_Q_NAME Transmission queue name (MQ_Q_NAME_LENGTH).
MQIA_ACCOUNTING_Q Controls collection of accounting data for queue. Not z/OS
MQIA_BACKOUT_THRESHOLD Backout threshold.
MQIA_CLWL_Q_PRIORITY Priority of queue
MQIA_CLWL_Q_RANK Rank of queue
MQIA_CLWL_USEQ Use remote queues
MQIA_CURRENT_Q_DEPTH Number of messages on queue.
MQIA_DEF_BIND Default binding.
MQIA_DEF_INPUT_OPEN_OPTION Default open-for-input option.
MQIA_DEF_PERSISTENCE Default message persistence.
MQIA_DEF_PRIORITY Default message priority.
MQIA_DEFINITION_TYPE Queue definition type.
MQIA_DIST_LISTS Distribution list support. Not z/OS
MQIA_HARDEN_GET_BACKOUT Whether to harden backout count.
MQIA_INDEX_TYPE Type of index maintained for queue. z/OS
MQIA_INHIBIT_GET Whether get operations are allowed.
MQIA_INHIBIT_PUT Whether put operations are allowed.
MQIA_MAX_MSG_LENGTH Maximum message length.
MQIA_MAX_Q_DEPTH Maximum number of messages allowed on queue.
MQIA_MSG_DELIVERY_SEQUENCE Whether message priority is relevant.
MQIA_NPM_CLASS Level of reliability for nonpersistent messages.
MQIA_OPEN_INPUT_COUNT Number of MQOPEN calls that have the queue open for input.
MQIA_OPEN_OUTPUT_COUNT Number of MQOPEN calls that have the queue open for output.
MQIA_Q_DEPTH_HIGH_EVENT Control attribute for queue depth high events. Not z/OS
MQIA_Q_DEPTH_HIGH_LIMIT High limit for queue depth. Not z/OS
MQIA_Q_DEPTH_LOW_EVENT Control attribute for queue depth low events. Not z/OS
MQIA_Q_DEPTH_LOW_LIMIT Low limit for queue depth. Not z/OS
MQIA_Q_DEPTH_MAX_EVENT Control attribute for queue depth max events. Not z/OS
MQIA_Q_SERVICE_INTERVAL Limit for queue service interval. Not z/OS
MQIA_Q_SERVICE_INTERVAL_EVENT Control attribute for queue service interval events. Not z/OS
MQIA_Q_TYPE Queue type.
MQIA_QSG_DISP Queue-sharing group disposition. z/OS
MQIA_RETENTION_INTERVAL Queue retention interval.
MQIA_SCOPE Queue definition scope. Not z/OS
MQIA_SHAREABILITY Whether queue can be shared for input.
MQIA_STATISTICS_Q Controls collection of statistics data for queue. Not z/OS
MQIA_TRIGGER_CONTROL Trigger control.
MQIA_TRIGGER_DEPTH Trigger depth.
MQIA_TRIGGER_MSG_PRIORITY Threshold message priority for triggers.
MQIA_TRIGGER_TYPE Trigger type.
MQIA_USAGE Usage.
Table 77. MQINQ attribute selectors for namelists
Selector Description Note
MQCA_ALTERATION_DATE Date of most-recent alteration (MQ_DATE_LENGTH).
MQCA_ALTERATION_TIME Time of most-recent alteration (MQ_TIME_LENGTH).
MQCA_NAMELIST_DESC Namelist description (MQ_NAMELIST_DESC_LENGTH).
MQCA_NAMELIST_NAME Name of namelist object (MQ_NAMELIST_NAME_LENGTH).
MQIA_NAMELIST_TYPE Namelist type. z/OS
MQCA_NAMES Names in the namelist (MQ_Q_NAME_LENGTH × Number of names in the list).
MQIA_NAME_COUNT Number of names in the namelist.
MQIA_QSG_DISP Queue-sharing group disposition. z/OS
Table 78. MQINQ attribute selectors for process definitions
Selector Description Note
MQCA_ALTERATION_DATE Date of most-recent alteration (MQ_DATE_LENGTH).
MQCA_ALTERATION_TIME Time of most-recent alteration (MQ_TIME_LENGTH).
MQCA_APPL_ID Application identifier (MQ_PROCESS_APPL_ID_LENGTH).
MQCA_ENV_DATA Environment data (MQ_PROCESS_ENV_DATA_LENGTH).
MQCA_PROCESS_DESC Description of process definition (MQ_PROCESS_DESC_LENGTH).
MQCA_PROCESS_NAME Name of process definition (MQ_PROCESS_NAME_LENGTH).
MQCA_USER_DATA User data (MQ_PROCESS_USER_DATA_LENGTH).
MQIA_APPL_TYPE Application type.
MQIA_QSG_DISP Queue-sharing group disposition. z/OS
Table 79. MQINQ attribute selectors for the queue manager
Selector Description Note
MQCA_ALTERATION_DATE Date of most-recent alteration (MQ_DATE_LENGTH).
MQCA_ALTERATION_TIME Time of most-recent alteration (MQ_TIME_LENGTH).
MQCA_CHANNEL_AUTO_DEF_EXIT Automatic channel definition exit name (MQ_EXIT_NAME_LENGTH).
MQCA_CHINIT_SERVICE_PARM Reserved for use by IBM.
MQCA_CLUSTER_WORKLOAD_DATA Data passed to cluster workload exit (MQ_EXIT_DATA_LENGTH).
MQCA_CLUSTER_WORKLOAD_EXIT Name of cluster workload exit (MQ_EXIT_NAME_LENGTH).
MQCA_COMMAND_INPUT_Q_NAME System command input queue name (MQ_Q_NAME_LENGTH).
MQCA_DEAD_LETTER_Q_NAME Name of dead-letter queue (MQ_Q_NAME_LENGTH).
MQCA_DEF_XMIT_Q_NAME Default transmission queue name (MQ_Q_NAME_LENGTH).
MQCA_DNS_GROUP Name of the group for the TCP listener that handles inbound transmissions for the queue-sharing group to join when using Workload Manager Dynamic Domain Name Services support. z/OS
MQCA_IGQ_USER_ID Intra-group queuing user identifier (MQ_USER_ID_LENGTH). z/OS
MQCA_LU_GROUP_NAME Generic LU name for the LU 6.2 listener that handles inbound transmissions for the queue-sharing group to use. z/OS
MQCA_LU_NAME Name of the LU to use for outbound LU 6.2 transmissions. Set this to the same LU that the listener uses for inbound transmissions. z/OS
MQCA_LU62_ARM_SUFFIX Suffix of the SYS1.PARMLIB member APPCPMxx, that nominates the LUADD for this channel initiator. z/OS
MQCA_Q_MGR_DESC Queue manager description (MQ_Q_MGR_DESC_LENGTH).
MQCA_Q_MGR_IDENTIFIER Queue-manager identifier (MQ_Q_MGR_IDENTIFIER_LENGTH).
MQCA_Q_MGR_NAME Name of local queue manager (MQ_Q_MGR_NAME_LENGTH).
MQCA_QSG_NAME Queue-sharing group name (MQ_QSG_NAME_LENGTH). z/OS
MQCA_REPOSITORY_NAME Name of cluster for which queue manager provides repository services (MQ_Q_MGR_NAME_LENGTH).
MQCA_REPOSITORY_NAMELIST Name of namelist object containing names of clusters for which queue manager provides repository services (MQ_NAMELIST_NAME_LENGTH).
MQIA_ACCOUNTING_CONN_OVERRIDE Override accounting settings. Not z/OS
MQIA_ACCOUNTING_INTERVAL How often to write intermediate accounting records. Not z/OS
MQIA_ACCOUNTING_MQI Controls collection of accounting information for MQI data. Not z/OS
MQIA_ACCOUNTING_Q Controls collection of accounting information for queues. Not z/OS
MQIA_ACTIVE_CHANNELS Maximum number of channels that can be active at any one time. z/OS
MQIA_ADOPTNEWMCA_CHECK Elements checked to determine whether to adopt an MCA when a new inbound channel is detected that has the same name as an MCA that is already active. z/OS
MQIA_ADOPTNEWMCA_INTERVAL Amount of time, in seconds, that the new channel waits for the orphaned channel to end. Not z/OS
MQIA_ADOPTNEWMCA_TYPE Whether to restart an orphaned instance of an MCA of a given channel type automatically when a new inbound channel request matching the AdoptNewMCACheck parameters is detected. z/OS
MQIA_AUTHORITY_EVENT Control attribute for authority events. Not z/OS
MQIA_BRIDGE_EVENT Control attribute for IMS bridge events. z/OS
MQIA_CHANNEL_AUTO_DEF Control attribute for automatic channel definition. Not z/OS
MQIA_CHANNEL_AUTO_DEF_EVENT Control attribute for automatic channel definition events. Not z/OS
MQIA_CHANNEL_EVENT Control attribute for channel events.
MQIA_CHINIT_ADAPTERS Number of adapter subtasks to use for processing WebSphere MQ calls. z/OS
MQIA_CHINIT_DISPATCHERS Number of dispatchers to use for the channel initiator. z/OS
MQIA_CHINIT_TRACE_AUTO_START Whether to start channel initiator trace automatically. z/OS
MQIA_CHINIT_TRACE_TABLE_SIZE Size of the channel initiator's trace data space (in MB). z/OS
MQIA_CLUSTER_WORKLOAD_LENGTH Cluster workload length.
MQIA_CLWL_MRU_CHANNELS Channel MRU.
MQIA_CLWL_USEQ Use remote queues.
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. Not z/OS
MQIA_DIST_LISTS Distribution list support. Not z/OS
MQIA_DNS_WLM Whether the TCP listener that handles inbound transmissions for the queue-sharing group registers with Workload Manager for Dynamic Domain Name Services. z/OS
MQIA_EXPIRY_INTERVAL Interval between scans for expired messages. z/OS
MQIA_IGQ_PUT_AUTHORITY Intra-group queuing put authority. z/OS
MQIA_INHIBIT_EVENT Control attribute for inhibit events. Not z/OS
MQIA_INTRA_GROUP_QUEUING Intra-group queuing support. z/OS
MQIA_LISTENER_TIMER Time interval (in seconds) between WebSphere MQ attempts to restart the listener if there has been an APPC or TCP/IP failure. z/OS
MQIA_LOCAL_EVENT Control attribute for local events. Not z/OS
MQIA_LOGGER_EVENT Control attribute for inhibit events. Not z/OS
MQIA_LU62_CHANNELS Maximum number of channels that can be current, or clients that can be connected, using the LU 6.2 transmission protocol. z/OS
MQIA_MAX_CHANNELS Maximum number of channels that can be current (including server-connection channels with connected clients). z/OS
MQIA_MAX_HANDLES Maximum number of handles.
MQIA_MAX_MSG_LENGTH Maximum message length.
MQIA_MAX_PRIORITY Maximum priority.
MQIA_MAX_UNCOMMITTED_MSGS Maximum number of uncommitted messages within a unit of work.
MQIA_OUTBOUND_PORT_MAX With MQIA_OUTBOUND_PORT_MIN, defines range of port numbers to use when binding outgoing channels. z/OS
MQIA_OUTBOUND_PORT_MIN With MQIA_OUTBOUND_PORT_MAX, defines range of port numbers to use when binding outgoing channels. z/OS
MQIA_PERFORMANCE_EVENT Control attribute for performance events. Not z/OS
MQIA_PLATFORM Platform on which the queue manager resides.
MQIA_RECEIVE_TIMEOUT Approximately how long a TCP/IP channel waits to receive data, including heartbeats, from its partner, before returning to the inactive state. This is the numeric value qualified by MQIA_RECEIVE_TIMEOUT_TYPE. z/OS
MQIA_RECEIVE_TIMEOUT_MIN Minimum time that a TCP/IP channel waits to receive data, including heartbeats, from its partner, before returning to the inactive state. z/OS
MQIA_RECEIVE_TIMEOUT_TYPE Approximately how long a TCP/IP channel waits to receive data, including heartbeats, from its partner, before returning to the inactive state. This is the qualifier applied to MQIA_RECEIVE_TIMEOUT. z/OS
MQIA_REMOTE_EVENT Control attribute for remote events. Not z/OS
MQIA_SSL_EVENT Control attribute for channel events.
MQIA_SSL_FIPS_REQUIRED Use only FIPS-certified algorithms for cryptography.
MQIA_SSL_RESET_COUNT SSL key reset count
MQIA_START_STOP_EVENT Control attribute for start stop events. Not z/OS
MQIA_STATISTICS_AUTO_CLUSSDR Controls collection of statistics monitoring information for cluster sender channels. Not z/OS
MQIA_STATISTICS_CHANNEL Controls collection of statistics data for channels. Not z/OS
MQIA_STATISTICS_INTERVAL How often to write statistics monitoring data. Not z/OS
MQIA_STATISTICS_MQI Controls collection of statistics monitoring information for queue manager. Not z/OS
MQIA_STATISTICS_Q Controls collection of statistics data for queues. Not z/OS
MQIA_SYNCPOINT Syncpoint availability.
MQIA_TCP_CHANNELS Maximum number of channels that can be current, or clients that can be connected, using the TCP/IP transmission protocol. z/OS
MQIA_TCP_KEEP_ALIVE Whether to use the TCP KEEPALIVE facility to check that the other end of the connection is still available. z/OS
MQIA_TCP_NAME Name of the TCP/IP system that you are using. z/OS
MQIA_TCP_STACK_TYPE 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. z/OS
MQIA_TRACE_ROUTE_RECORDING Controls recording of trace-route information. z/OS
MQIA_TRIGGER_INTERVAL Trigger interval.


 

Home