If CHLDISP is set to SHARED, CMDSCOPE must be blank or the local queue manager.
You can specify a queue manager name only if you are using a queue-sharing group environment and if the command server is enabled.
In conjunction with the various values of the CMDSCOPE parameter, this parameter controls two types of channel:
A sending channel is shared if its transmission queue has a disposition of SHARED.
A sending channel is private if its transmission queue has a disposition other than SHARED.
The combination of the CHLDISP and CMDSCOPE parameters also controls from which queue manager the channel is operated. The possible options are:
The various combinations of CHLDISP and CMDSCOPE are summarized in Table 20
CHLDISP | CMDSCOPE( ) or CMDSCOPE (local-qmgr) | CMDSCOPE (qmgr-name) | CMDSCOPE(*) |
---|---|---|---|
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 |
SHARED | For RCVR and SVRCONN channels, stop as shared channel
on all active queue managers.
For SDR, RQSTR, and SVR channels, 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 CMDSCOPE 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 |
For a receiving channel, if there is no batch in progress, the channel waits for either:
before it stops.
For server-connection channels, allows the current connection to end.
This is the default.
For server-connection channels, breaks the current connection, returning MQRC_CONNECTION_BROKEN.
For server-connection channels, breaks the current connection, returning MQRC_CONNECTION_BROKEN.
This is the default if QMNAME or CONNAME are not specified.
This is the default if QMNAME or CONNAME are specified.
Notices |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
csqzaj10143 |