runswchl

Purpose

Usage notes

You must log on as an Administrator to run this command.

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.

If you set the -q parameter, the command does not perform the switch, but it provides the list of channels that would be switched.

Required parameters

-m QmgrName

The queue manager to run the command against. The queue manager must be started.

-c *

All the cluster-sender channels

-c GenericChannelName

All matching cluster-sender channels

-c ChannelName

Single cluster-sender channel.

Optional parameters

-q

Display the state of one or more channels. If you omit this parameter, the commands switches any stopped or inactive channels that require switching.

-n

When switching transmission queues, do not transfer messages from the old queue to the new transmission queue.

Note: Take care with the -n option: messages on the old transmission queue are not transferred unless you associate the transmission queue with another cluster-sender channel.

Return codes

0

The command completed successfully

10

The command completed with warnings.

20

The command completed with errors.