Specifies the disposition of the channels to be stopped.
The value can be:
A sending channel is private if its transmission queue has a disposition other than MQQSGD_SHARED.
A sending channel is shared if its transmission queue has a disposition of MQQSGD_SHARED.
The combination of the ChannelDisposition and CommandScope parameters also controls from which queue manager the channel is operated. The possible options are:
The various combinations of ChannelDisposition and CommandScope are summarized in Table 14
ChannelDisposition | CommandScope blank or local-qmgr | CommandScope qmgr-name | CommandScope(*) |
---|---|---|---|
MQCHLD_PRIVATE | Stop as a private channel on the local queue manager | Stop as a private channel on the named queue manager | Stop as a private channel on all active queue managers |
MQCHLD_SHARED | For channels of ChannelType MQCHT_RECEIVER
or MQCHT_SVRCONN, stop as shared channel on all active queue managers.
For channels of ChannelType MQCHT_SENDER, MQCHT_REQUESTER, and MQCHT_SERVER, stop as a shared channel on the queue manager where it is running. If the channel is in an inactive state (not running), or if it is in RETRY state because the channel initiator on which it was running has stopped, a STOP request for the channel is issued on the local queue manager. This might automatically generate a command using CommandScope and send it to the appropriate queue manager. If there is no definition for the channel on the queue manager to which the command is sent, or if the definition is unsuitable for the command, the command fails. The definition of a channel on the queue manager where the command is entered might be used to determine the target queue manager where the command is actually run. Therefore, it is important that channel definitions are consistent. Inconsistent channel definitions might result in unexpected command behavior. |
Not permitted | Not permitted |
The value can be:
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.
This is the connection name of the channel to be stopped. If this parameter is omitted, all channels with the specified channel name and remote queue manager name are stopped. On platforms other than z/OS, the maximum length of the string is MQ_CONN_NAME_LENGTH. On z/OS, the maximum length of the string is MQ_LOCAL_ADDRESS_LENGTH.
If this parameter is specified, ChannelStatus must be MQCHS_INACTIVE.
The value can be:
This is the name of the remote queue manager to which the channel is connected. If this parameter is omitted, all channels with the specified channel name and connection name are stopped. The maximum length of the string is MQ_Q_MGR_NAME_LENGTH.
If this parameter is specified, ChannelStatus must be MQCHS_INACTIVE.
Notices |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
csqzac04277 |