This specifies that eligible queues are limited to those having the specified CFStructure value. If this is not specified, then all queues are eligible.
Generic CF structure names are supported. A generic name is a character string followed by an asterisk (*), for example ABC*, and it selects all CF structures having names that start with the selected character string. An asterisk on its own matches all possible names.
The maximum length of the string is MQ_CF_STRUC_NAME_LENGTH.
This parameter requests that, in addition to information about attributes of queues defined on this queue manager, cluster information about these and other queues in the repository that match the selection criteria will be displayed.
In this case, there might be multiple queues with the same name displayed. The cluster information is shown with a queue type of MQQT_CLUSTER.
The cluster information is obtained locally from the queue manager.
This specifies that eligible queues are limited to those having the specified ClusterName value. If this is not specified, then all queues are eligible.
Generic cluster names are supported. A generic name is a character string followed by an asterisk (*), for example ABC*, and it selects all clusters having names that start with the selected character string. An asterisk on its own matches all possible names.
The maximum length of the string is MQ_CLUSTER_NAME_LENGTH.
This specifies that eligible queues are limited to those having the specified ClusterNameList value. If this is not specified, then all queues are eligible.
Generic cluster namelists are supported. A generic name is a character string followed by an asterisk (*), for example ABC*, and it selects all cluster namelists having names that start with the selected character string. An asterisk on its own matches all possible names.
Specifies how the command is executed when the queue manager is a member of a queue-sharing group. You can specify one of the following:
The maximum length is MQ_QSG_NAME_LENGTH.
You cannot use CommandScope as a parameter to filter on.
If you specify an integer filter for Qtype or PageSetID, you cannot also specify the Qtype or PageSetID parameter.
If you specify an integer filter, you cannot also specify a string filter using the StringFilterCommand parameter.
This specifies that eligible queues are limited to those having the specified PageSetID value. If this is not specified, then all queues are eligible.
The attribute list might specify the following on its own (this is the default value used if the parameter is not specified):
or a combination of the parameters in the following table:
Local queue | Model queue | Alias queue | Remote queue | Cluster queue | |
---|---|---|---|---|---|
MQCA_ALTERATION_DATE
The date on which the information was last altered |
X | X | X | X | X |
MQCA_ALTERATION_TIME
The time at which the information was last altered |
X | X | X | X | X |
MQCA_BACKOUT_REQ_Q_NAME
Excessive backout requeue name |
X | X | |||
MQCA_BASE_NAME
Name of queue that alias resolves to |
X | ||||
MQCA_CF_STRUC_NAME
Coupling facility structure name. This attribute is valid on z/OS only |
X | X | |||
MQCA_CLUSTER_DATE
Date when the definition became available to the local queue manager |
X | ||||
MQCA_CLUSTER_NAME
Cluster name |
X | X | X | X | |
MQCA_CLUSTER_NAMELIST
Cluster namelist |
X | X | X | ||
MQCA_CLUSTER_Q_MGR_NAME
Queue manager name that hosts the queue |
X | ||||
MQCA_CLUSTER_TIME
Time when the definition became available to the local queue manager |
X | ||||
MQCA_CREATION_DATE
Queue creation date |
X | X | |||
MQCA_CREATION_TIME
Queue creation time |
X | X | |||
MQCA_INITIATION_Q_NAME
Initiation queue name |
X | X | |||
MQCA_PROCESS_NAME
Name of process definition |
X | X | |||
MQCA_Q_DESC
Queue description |
X | X | X | X | X |
MQCA_Q_MGR_IDENTIFIER
Internally generated queue manager name |
X | ||||
MQCA_Q_NAME
Queue name |
X | X | X | X | X |
MQCA_Q_TYPE
Queue type |
X | X | X | X | X |
MQCA_REMOTE_Q_MGR_NAME
Name of remote queue manager |
X | ||||
MQCA_REMOTE_Q_NAME
Name of remote queue as known locally on the remote queue manager |
X | ||||
MQCA_STORAGE_CLASS
Storage class. This is valid on z/OS only |
X | X | |||
MQCA_TPIPE_NAME
The TPIPE name used for communication with OTMA using the WebSphere(R) MQ IMS(TM) Bridge |
X | ||||
MQCA_TRIGGER_DATA
Trigger data |
X | X | |||
MQCA_XMIT_Q_NAME
Transmission queue name |
X | ||||
MQIA_ACCOUNTING_Q
Accounting data collection |
X | X | |||
MQIA_BACKOUT_THRESHOLD
Backout threshold |
X | X | |||
MQIA_CLUSTER_Q_TYPE
Cluster queue type |
X | ||||
MQIA_CLWL_Q_PRIORITY
Cluster workload queue priority |
X | X | X | X | |
MQIA_CLWL_Q_RANK
Cluster workload queue rank |
X | X | X | X | |
MQIA_CLWL_USEQ
Cluster workload use remote setting |
X | ||||
MQIA_CURRENT_Q_DEPTH
Number of messages on queue |
X | ||||
MQIA_DEF_BIND
Default binding |
X | X | X | X | |
MQIA_DEF_INPUT_OPEN_OPTION
Default open-for-input option |
X | X | |||
MQIA_DEF_PERSISTENCE
Default message persistence |
X | X | X | X | X |
MQIA_DEF_PRIORITY
Default message priority |
X | X | X | X | X |
MQIA_DEFINITION_TYPE
Queue definition type |
X | X | |||
MQIA_DIST_LISTS
Distribution list support. This is not valid on z/OS |
X | X | |||
MQIA_HARDEN_GET_BACKOUT
Whether to harden backout count |
X | X | |||
MQIA_INDEX_TYPE
Index type. This attribute is valid on z/OS only. |
X | X | |||
MQIA_INHIBIT_GET
Whether get operations are allowed |
X | X | X | ||
MQIA_INHIBIT_PUT
Whether put operations are allowed |
X | X | X | X | X |
MQIA_MAX_MSG_LENGTH
Maximum message length |
X | X | |||
MQIA_MAX_Q_DEPTH
Maximum number of messages allowed on queue |
X | X | |||
MQIA_MONITORING_Q
Online monitoring data collection |
X | X | |||
MQIA_MSG_DELIVERY_SEQUENCE
Whether message priority is relevant |
X | X | |||
MQIA_NPM_CLASS
Level of reliability assigned to non-persistent messages that are put to the queue |
X | X | |||
MQIA_OPEN_INPUT_COUNT
Number of MQOPEN calls that have the queue open for input |
X | ||||
MQIA_OPEN_OUTPUT_COUNT
Number of MQOPEN calls that have the queue open for output |
X | ||||
MQIA_PAGESET_ID
Page set identifier |
X | ||||
MQIA_Q_DEPTH_HIGH_EVENT
Control attribute for queue depth high events. You cannot use this as a filter attribute. |
X | X | |||
MQIA_Q_DEPTH_HIGH_LIMIT
High limit for queue depth |
X | X | |||
MQIA_Q_DEPTH_LOW_EVENT
Control attribute for queue depth low events. You cannot use this as a filter attribute. |
X | X | |||
MQIA_Q_DEPTH_LOW_LIMIT
Low limit for queue depth |
X | X | |||
MQIA_Q_DEPTH_MAX_EVENT
Control attribute for queue depth max events |
X | X | |||
MQIA_Q_SERVICE_INTERVAL
Limit for queue service interval |
X | X | |||
MQIA_Q_SERVICE_INTERVAL_ EVENT
Control attribute for queue service interval events |
X | X | |||
MQIA_RETENTION_INTERVAL
Queue retention interval |
X | X | |||
MQIA_SCOPE
Queue definition scope. This is not valid on z/OS or i5/OS |
X | X | X | ||
MQIA_SHAREABILITY
Whether queue can be shared |
X | X | |||
MQIA_STATISTICS_Q
Statistics data collection. This is valid only on AIX, HP-UX, Linux, i5/OS, Solaris, and Windows. |
X | X | |||
MQIA_TRIGGER_CONTROL
Trigger control |
X | X | |||
MQIA_TRIGGER_DEPTH
Trigger depth |
X | X | |||
MQIA_TRIGGER_MSG_PRIORITY
Threshold message priority for triggers |
X | X | |||
MQIA_TRIGGER_MTYPE
Trigger type |
X | X | |||
MQIA_USAGE
Usage |
X | X |
Specifies the disposition of the object for which information is to be returned (that is, where it is defined and how it behaves). The value can be:
If there is a shared queue manager environment, and the command is being executed on the queue manager where it was issued, this option also displays information for objects defined with MQQSGD_GROUP or MQQSGD_SHARED.
If MQQSGD_LIVE is specified or defaulted, or if MQQSGD_ALL is specified in a shared queue manager environment, the command might give duplicated names (with different dispositions).
You cannot use QSGDisposition as a parameter to filter on.
If this parameter is present, eligible queues are limited to those of the specified type. Any attribute selector specified in the QAttrs list which is valid only for queues of a different type or types is ignored; no error is raised.
If this parameter is not present (or if MQQT_ALL is specified), queues of all types are eligible. Each attribute specified must be a valid queue attribute selector (that is, it must be one of those in the following list), but it need not be applicable to all (or any) of the queues actually returned. Queue attribute selectors that are valid but not applicable to the queue are ignored, no error messages occur and no attribute is returned. The value can be:
This specifies that eligible queues are limited to those having the specified StorageClass value. If this is not specified, then all queues are eligible.
Generic names are supported. A generic name is a character string followed by an asterisk (*), for example ABC*, and it selects all storage classes having names that start with the selected character string. An asterisk on its own matches all possible names.
The maximum length of the string is MQ_STORAGE_CLASS_LENGTH.
If you specify a string filter for ClusterName, ClusterNameList, StorageClass, or CFStructure, you cannot also specify that as a parameter.
If you specify a string filter, you cannot also specify an integer filter using the IntegerFilterCommand parameter.
Notices |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
csqzac04187 |