Switching messages to another console *SWITCH,from

Function

Use the *SWITCH command to switch console message from one RJP console to another or to stop and start console message traffic to a specific RJP console.

Syntax


>>-*SWITCH--,--from-- ---rjp-- ---con--------------------------->

>--+-,--to-- ---rjp-- ---con-+---------------------------------><
   '-,--NONE-----------------'

Parameters

from-rjp-con: Specifies the name of the RJP console whose message traffic will be affected.
to-rjp-con: Specifies the name of the RJP console to which output messages destined for the from-rjp-con will be routed. If you want to start message queuing to this console make the from-rjp-con and the to-rjp-con the same.
NONE: Indicates that the specified console is marked as switched. All console buffers queued to that console are removed and all queuing to it stops. The messages originally sent to the console will still appear in the log.

Rules

The *SWITCH command must be issued from an MCS console. It is rejected when entered from an RJP console.
JES3 only allows RJP consoles to be specified on the *SWITCH command as a value for the from-con or to-con variable.
JES3 will not automatically switch an RJP console in the event of an error.
The *SWITCH command provides a single level switch capacity. For example, messages switched from console A to console B cannot be forwarded to a console C by switching console B to console C. Console A must switch back to itself before console B can be switched.
To restore a console to normal operation (that is, to route to a console only those messages that should normally appear at that console), place the name of the console to be restored in both parameters of the *SWITCH command.
Messages queued to the from-rjp-con at the time of the switch will be displayed on the to-rjp-con with a switch character (#) immediately following the time stamp. Subsequent messages queued to the to-rjp-con as a result of the switch will not include this switch character.
Messages spooled to an RJP console remain spooled to that RJP console. The messages cannot be switched or freed from that console.

Examples

Switch messages from console RTM01 to console RTM02:

*SWITCH,RTM01,RTM02

Restore console RMT01 (previously switched by the first example) to normal operation:

*SWITCH,RTM01, RTM01

Remove all console buffers queued to RTM01 and stop queuing to RTM01:

*SWITCH,RTM01,NONE

Restore console RTM01 to normal operations:

*SWITCH,RTM01,RTM01