tcl.mirror

Verb: Access/TCL, Releases: AP

Directs output from 'master' to one or more 'slave' terminals.

Syntax

mirror port.number{,port.number...} {(options} mirror port.number{-port.number...} {(options}

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.

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.

See Also

Command Name Type Description
tcl.converse Verb: Access Connects current process to given device.
port.number Definition The port number associated with the process.
system.privileges Definition Description of privilege levels.
system.debugger.me Command Attaches current process to remote process.
tcl.unlink-pibdev Verb: Access Unlinks a process from a port.
tcl.:reset-async Verb: Access Resets current or all ports.
tcl.cleanpibs Verb: Access Clears tandem connects for all ports.
filename.devs Definition Device file.
tcl.link-pibdev Verb: Access Links the port to the device#.
tcl.dev-det Verb: Access Detaches a port from the current port.
tcl.tandem Verb: Access Logically link two devices to the same process.
tcl.:ent-mon Verb: Access Monitor data sent to an entity

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.