runswchl

Switch or query the cluster transmission queues associated with cluster-sender channels.

Purpose

You can use the runswchl to switch or query cluster transmission queues that are associated with cluster-sender channels.

The command switches all the stopped or inactive cluster-sender channels that match the -c parameter, require switching, and can be switched. The command reports back on the channels that are switched, the channels that do not require switching, and the channels it cannot switch because they are not stopped or inactive.

Syntax

Parameters

-m QmgrName: Specifies the queue manager to run the command against.; The queue manager must be started.; This parameter is required.
-c ChannelName: Specifies the cluster-sender channels to run the command against.; The ChannelName can specify a single channel, or multiple channels if you use a wildcard in the value. You can use an asterisk (*) as a wildcard to match zero or more characters. You can use an asterisk (*) to specify all cluster-sender channels.; This parameter is required.
-q: Specifies that the state of the channels is displayed.; If you specify this parameter, no switching occurs. Instead, channels that would be switched are listed.
-n: Specifies that when transmission queues are switched, messages are not transferred from the old queue to the new transmission queue.; Messages on the old transmission queue are not transferred unless you associate the transmission queue with another cluster-sender channel.

Usage notes

This command must be run from the IBM® MQ administration mode. If the system is in the IBM MQ administration mode the prompt includes mqa(mqcli)#. To enter the IBM MQ administration mode, enter mqcli on the command line. To exit the IBM MQ administration mode, enter exit on the command line.
For more information about this command in IBM MQ, see runswchl in the IBM MQ documentation.

Examples

The following command displays the configuration state of cluster-sender channel TO.QM1:
```
runswchl -m QM1 -c TO.QM1 -q
```
The following command switches the transmission queue for cluster-sender channel TO.QM3 without moving the messages on it:
```
runswchl -m QM1 -c TO.QM3 -n
```
The following command switches the transmission queue for cluster-sender channel TO.QM3 and move the messages on it:
```
runswchl -m QM1 -c TO.QM3
```
The following command displays the configuration state of all cluster-sender channels on QM1:
```
runswchl -m QM1 -c * -q
```
The following command displays the configuration state of all cluster-sender channels with a generic name of TO.*:
```
runswchl -m QM1 -c TO.* -q
```