174
LINE_SWITCH Directive
Redirect Console Input/Output
Formats
1. Switch File (0): LINE_SWITCH chan [,ERR=stmtref]
2. Switch File (0): LINE_SWITCH [device$,ERR=stmtref]
Where:
chan
Channel or logical file number to which to redirect file 0 zero input and
output.
device$
Name of the device to which to switch file 0 zero. String expression.
stmtref
Program line number or label to transfer control to.
Description
Use the LINE_SWITCH directive to switch all I/O currently sent to channel or logical
file number 0 (zero, the terminal) to another device. Its primary purposes are to
allow for secondary users on a PC or to provide remote maintenance capability.
While the LINE_SWITCH is in effect, the original device is disabled. ProvideX will
expect to receive all input from and send all output to the new device designated as
file or channel 0 zero.
Use a LINE_SWITCH directive with no parameters to restore communications with
the original device on channel (logical file number) 0 and CLOSE the alternate file.
Examples
-> LINE_SWITCH "PORT2" ! Defines/opens PORT2 as logical file number (0)
-> LINE_SWITCH ! Closes PORT2, restores terminal/console as logical file
#(0)