Specifies the disposition of the channels for which information is to be returned. The value can be:
In a shared queue environment where the command is being executed on the queue manager where it was issued, or if ChannelInstanceType has a value of MQOT_CURRENT_CHANNEL, this option also displays the requested status information for shared channels.
The status information that is returned for various combinations of ChannelDisposition, CommandScope, and status type, is summarized in Table 6, Table 7, and Table 8.
ChannelDisposition | CommandScope blank or local queue manager | CommandScope(qmgr-name) | CommandScope(*) |
---|---|---|---|
MQCHLD_PRIVATE | Common and current-only status for current private channels on the local queue manager | Common and current-only status for current private channels on the named queue manager | Common and current-only status for current private channels on all queue managers |
MQCHLD_SHARED | Common and current-only status for current shared channels on the local queue manager | Common and current-only status for current shared channels on the named queue manager | Common and current-only status for current shared channels on all queue managers |
MQCHLD_ALL | Common and current-only status for current private and shared channels on the local queue manager | Common and current-only status for current private and shared channels on the named queue manager | Common and current-only status for current private and shared channels on all active queue managers |
ChannelDisposition | CommandScope blank or local queue manager | CommandScope(qmgr-name) | CommandScope(*) |
---|---|---|---|
MQCHLD_PRIVATE | ChannelStatus and short status for current private channels on the local queue manager | ChannelStatus and short status for current private channels on the named queue manager | ChannelStatus and short status for current private channels on all active queue managers |
MQCHLD_SHARED | ChannelStatus and short status for current shared channels on all active queue managers in the queue-sharing group | Not permitted | Not permitted |
MQCHLD_ALL | ChannelStatus and short status for current private channels on the local queue manager and current shared channels in the queue-sharing group(1) | ChannelStatus and short status for current private channels on the named queue manager | ChannelStatus and short status for current private, and shared, channels on all active queue managers in the queue-sharing group(1) |
Note:
|
ChannelDisposition | CommandScope blank or local queue manager | CommandScope(qmgr-name) | CommandScope(*) |
---|---|---|---|
MQCHLD_PRIVATE | Common status for saved private channels on the local queue manager | Common status for saved private channels on the named queue manager | Common status for saved private channels on all active queue managers |
MQCHLD_SHARED | Common status for saved shared channels on all active queue managers in the queue-sharing group | Not permitted | Not permitted |
MQCHLD_ALL | Common status for saved private channels on the local queue manager and saved shared channels in the queue-sharing group | Common status for saved private channels on the named queue manager | Common status for saved private, and shared, channels on all active queue managers in the queue-sharing group |
You cannot use this parameter as a filter keyword.
If status information is requested which is not relevant for the particular channel type, this is not an error. Similarly, it is not an error to request status information that is applicable only to active channels for saved channel instances. In both of these cases, no structure is returned in the response for the information concerned.
For a saved channel instance, the MQCACH_CURRENT_LUWID, MQIACH_CURRENT_MSGS, and MQIACH_CURRENT_SEQ_NUMBER attributes have meaningful information only if the channel instance is in doubt. However, the attribute values are still returned when requested, even if the channel instance is not in-doubt.
The attribute list might specify the following on its own:
This is the default value used if the parameter is not specified or it can specify a combination of the following:
Relevant for common status
The following information applies to all sets of channel status, whether or not the set is current.
MQCACH_CURRENT_LUWID, MQCACH_LAST_LUWID, MQIACH_CURRENT_MSGS, MQIACH_CURRENT_SEQ_NUMBER, MQIACH_INDOUBT_STATUS and MQIACH_LAST_SEQ_NUMBER do not apply to server-connection channels, and no values are returned. If specified on the command, they are ignored.
Relevant for current-only status
The following information applies only to current channel instances. The information applies to all channel types, except where stated.
This parameter is not valid on z/OS.
You cannot use MQCACH_MCA_JOB_NAME as a parameter to filter on.
The maximum length of the string is MQ_APPL_TAG_LENGTH.
You cannot use MQIACF_MONITORING as a parameter to filter on.
You cannot use MQIACH_BATCH_SIZE_INDICATOR as a parameter to filter on.
You cannot use MQIACH_EXIT_TIME_INDICATOR as a parameter to filter on.
You cannot use MQIACH_COMPRESSION_RATE as a parameter to filter on.
You cannot use MQIACH_COMPRESSION_TIME as a parameter to filter on.
You cannot use MQIACH_NETWORK_TIME_INDICATOR as a parameter to filter on.
You cannot use MQIACH_XMITQ_TIME_INDICATOR as a parameter to filter on.
You cannot use MQIACH_MCA_STATUS as a parameter to filter on.
The following is supported on HP OpenVMS, i5/OS, Compaq NonStop Kernel, UNIX systems, Windows, and z/OS:
The following is supported on HP OpenVMS, Compaq NonStop Kernel, i5/OS, UNIX systems, Windows and z/OS:
The following attributes do not apply to server-connection channels, and no values are returned. If specified on the command they are ignored:
Relevant for short status
The following parameter applies to current channels on z/OS:
It is always returned regardless of the channel instance attributes requested.
The value can be:
This is the default, and indicates that only current status information for active channels is to be returned.
Both common status information and active-only status information can be requested for current channels.
Specify this to cause saved status information for both active and inactive channels to be returned.
Only common status information can be returned. Active-only status information is not returned for active channels if this keyword is specified.
Specify this to cause short status information for current channels to be returned.
Other common status and current-only status information is not returned for current channels if this keyword is specified.
You cannot use MQIACH_CHANNEL_INSTANCE_TYPE as a parameter to filter on.
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 this parameter is present, eligible channel instances are limited to those using this connection name. If it is not specified, eligible channel instances are not limited in this way.
The connection name is always returned, regardless of the instance attributes requested.
The value returned for ConnectionName might not be the same as in the channel definition, and might differ between the current channel status and the saved channel status. (Using ConnectionName for limiting the number of sets of status is therefore not recommended.)
For example, when using TCP, if ConnectionName in the channel definition :
The maximum length of the string is MQ_CONN_NAME_LENGTH.
If you specify an integer filter, you cannot also specify a string filter using the StringFilterCommand parameter.
If you specify a string filter for ConnectionName or XmitQName, you cannot also specify the ConnectionName or XmitQName parameter.
If you specify a string filter, you cannot also specify an integer filter using the IntegerFilterCommand parameter.
If this parameter is present, eligible channel instances are limited to those using this transmission queue. If it is not specified, eligible channel instances are not limited in this way.
The transmission queue name is always returned, regardless of the instance attributes requested.
The maximum length of the string is MQ_Q_NAME_LENGTH.
Notices |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
csqzac04155 |