Home

 

Optional parameters

 

ChannelDisposition (MQCFIN)

Channel disposition (parameter identifier: MQIACH_CHANNEL_DISP). This parameter applies to z/OS only.

Specifies the disposition of the channels to be stopped.

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.

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 STOP CHANNEL
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

ChannelStatus (MQCFIN)

The new state of the channel after the command is executed (parameter identifier: MQIACH_CHANNEL_STATUS).

The value can be:

MQCHS_INACTIVE

Channel is inactive.

MQCHS_STOPPED

Channel is stopped. This is the default if nothing is specified.

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.

ConnectionName (MQCFST)

Connection name of channel to be stopped (parameter identifier: MQCACH_CONNECTION_NAME).

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.

Mode (MQCFIN)

How the channel should be stopped (parameter identifier: MQIACF_MODE).

The value can be:

MQMODE_QUIESCE

Quiesce the channel. This is the default.

MQMODE_FORCE

Stop the channel immediately; the channel's thread or process is not terminated.

MQMODE_TERMINATE

Stop the channel immediately; the channel's thread or process is terminated.

This parameter was previously called Quiesce (MQIACF_QUIESCE), with values MQQO_YES and MQQO_NO. The old names can still be used.

QMgrName (MQCFST)

Name of remote queue manager (parameter identifier: MQCA_Q_MGR_NAME).

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.

 

Parent topic:

Stop Channel


pc14350_


 

Home