TACL Reference Manual

UTILS:TACL Commands and Functions
HP NonStop TACL Reference Manual429513-018
8-222
SWITCH Command
SWITCH Command
Use the SWITCH command to make your TACL backup the primary process,
initializing itself as though you had just logged on to it. The former primary process
becomes the backup. The SWITCH command is an alias for the #SWITCH built-in
function.
Considerations
To use the switch command, your TACL must have a backup process. To create a
backup process, include it in the TACL RUN command or use the BACKUPCPU
command.
The SWITCH command must be entered interactively. Do not include the SWITCH
command in an IN file specified in a command to run TACL; if you do so, TACL
performs the switch before processing other commands-and each switch causes
an initialization so that the TACL process continues to switch processors.
SWITCH establishes an initial logon state, resetting all ASSIGNs, PARAMs, and
DEFINEs, invoking the TACLLOCL file and your TACLCSTM file, and setting the
history buffer index to 1.
If an error occurs while TACL is trying to create the backup process or if the
backup CPU is down, TACL waits 3 minutes before trying to create the backup.
All events, such as a backup-create error or an I/O error event, and the error
details are logged to the primary or $0 collector. This format is used:
TACL BACKUP CREATE ERROR: error, DETAIL: error-detail
error
is the error returned by PROCESS_CREATE.
error-detail
is the error detail value returned by PROCESS_CREATE.
For more information on the $0 collector, see the EMS Manual.
Example
Assume that the primary TACL process that controls your terminal is running in CPU 5,
and the backup TACL process is running in CPU 4. (To display the CPU numbers of
the processors where your TACL processes are running, use the WHO or STATUS
command.)
SWITCH