tcl.mirror Verb: Access/TCL

tcl.mirror

Command tcl.mirror Verb: Access/TCL
Applicable release versions: AP
Category TCL (746)
Description attaches the current process (the "master") to one or more "slave" processes. All characters input or output to or from the "master" process display on each "slave" process.

The process which initiates the "mirror" command is the "master". The process being attached is the "slave" or "target".

The target "slave" device (the one(s) being "linked" to the current device) must be available on the given "port.number(s)". It (they) may not be already attached to another process.

Multiple "slave" terminals may be designated and must be indicated in ascending order.

The "master" process may add additional "slaves" without terminating existing "slaves".

A "hotkey" sequence disconnects the link. The default "hotkey" sequence is <escape>x. If an "esc-data" has not been issued previously, the process issues it automatically, so the process will not get locked out from being able to suspend "mirror".

Either the "master" or "slave" can terminate "mirror" with the "hotkey" sequence. If a "slave" terminates, only that particular process is taken out of the "mirror" mode. If there are other "slave" processes still active, they are not affected. If the "master" process terminates, all "slaves" are disconnected.

On all Unix implementations, if the Pick process is not connected to the virtual machine, then "mirror" is not allowed, even if the "where" verb with a "z" option shows the port as being available.
Syntax mirror port.number{,port.number...} {(options}
mirror port.number{-port.number...} {(options}
Options d Designates the sequence of characters to terminate "converse" mode. Each character is provided in its hexadecimal equivalent of its ASCII value. Each character is separated by a comma. For example, "d/41,42,43,44", indicates that an "ABCD" will disconnect the link.

x Terminates mirror mode on target device number.
Example
mirror 2,13,32

Attaches terminals on ports 2, 13 and 32 to the current process.
 
mirror 2,5-10

Attaches port 2 and ports 5 through 10.

mirror 3 (d/2b,2b,2b

Attaches port 3 and sets the hotkey sequence to "+++".

mirror 42 (x

Terminates mirror mode on port 42.

mirror 1-20

Attaches ports 1 through 20 to the current port.
Purpose
Related tcl.converse
port.number
system.privileges
system.debugger.me
tcl.unlink-pibdev
tcl.:reset-async
tcl.cleanpibs
filename.devs
tcl.link-pibdev
tcl.dev-det
tcl.tandem
tcl.:ent-mon