Optional parameters

Home

Optional parameters

CommandScope (MQCFST)

Command scope (parameter identifier: MQCACF_COMMAND_SCOPE). This parameter applies to z/OS only.
Specifies how the command is executed when the queue manager is a member of a queue-sharing group. We can specify one of the following:

blank (or omit the parameter altogether). The command is executed on the queue manager on which it was entered.
a queue manager name. The command is executed on the queue manager you specify, providing it is active within the queue sharing group. If you specify a queue manager name other than the queue manager on which it was entered, be using a queue-sharing group environment, and the command server must be enabled.
an asterisk (*). The command is executed on the local queue manager and is also passed to every active queue manager in the queue-sharing group.

The maximum length is MQ_QSG_NAME_LENGTH.

ChannelDisposition (MQCFIN)

Channel disposition (parameter identifier: MQIACH_CHANNEL_DISP). This parameter applies to z/OS only.
Specifies the disposition of the channels to be started.
The value can be:

MQCHLD_PRIVATE

A receiving channel is private if it was started in response to an inbound transmission directed to the queue manager.
A sending channel is private if its transmission queue has a disposition other than MQQSGD_SHARED.

MQCHLD_SHARED

A receiving channel is shared if it was started in response to an inbound transmission directed to the queue-sharing group.
A sending channel is shared if its transmission queue has a disposition of MQQSGD_SHARED.

MQCHLD_FIXSHARED

Shared channels tied to a specific queue manager.

The combination of the ChannelDisposition and CommandScope parameters also controls from which queue manager the channel is operated. The possible options are:

On the local queue manager where the command is issued.
On another specific named queue manager in the group.
On every active queue manager in the group.
On the most suitable queue manager in the group, determined automatically by the queue manager itself.

The various combinations of ChannelDisposition and CommandScope are summarized in Table 1

ChannelDisposition and CommandScope for START CHANNEL
ChannelDisposition CommandScope blank or local-qmgr CommandScope qmgr-name CommandScope(*)
MQCHLD_PRIVATE Start as a private channel on the local queue manager Start as a private channel on the named queue manager Start as a private channel on all active queue managers
MQCHLD_SHARED For channels of ChannelType MQCHT_SENDER, MQCHT_REQUESTER, and MQCHT_SERVER, start as a shared channel on the most suitable queue manager in the group.
For a shared channel of ChannelType MQCHT_RECEIVER and MQCHT_SVRCONN, start the channel on all active queue managers.
For a shared channel of ChannelType MQCHT_CLUSSDR and MQCHT_CLUSRCVR, this option is not permitted.
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
MQCHLD_FIXSHARED For a shared channel of ChannelType MQCHT_SENDER, MQCHT_REQUESTER, and MQCHT_SERVER, with a nonblank ConnectionName, start as a shared channel on the local queue manager. For a shared channel of ChannelType MQCHT_SENDER, MQCHT_REQUESTER, and MQCHT_SERVER, with a nonblank ConnectionName, start as a shared channel on the named queue manager. Not permitted

Parent topic:
Start Channel

pc14210_

Home

ChannelDisposition	CommandScope blank or local-qmgr	CommandScope qmgr-name	CommandScope(*)
MQCHLD_PRIVATE	Start as a private channel on the local queue manager	Start as a private channel on the named queue manager	Start as a private channel on all active queue managers
MQCHLD_SHARED	For channels of ChannelType MQCHT_SENDER, MQCHT_REQUESTER, and MQCHT_SERVER, start as a shared channel on the most suitable queue manager in the group. For a shared channel of ChannelType MQCHT_RECEIVER and MQCHT_SVRCONN, start the channel on all active queue managers. For a shared channel of ChannelType MQCHT_CLUSSDR and MQCHT_CLUSRCVR, this option is not permitted. 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
MQCHLD_FIXSHARED	For a shared channel of ChannelType MQCHT_SENDER, MQCHT_REQUESTER, and MQCHT_SERVER, with a nonblank ConnectionName, start as a shared channel on the local queue manager.	For a shared channel of ChannelType MQCHT_SENDER, MQCHT_REQUESTER, and MQCHT_SERVER, with a nonblank ConnectionName, start as a shared channel on the named queue manager.	Not permitted