/BYPASS_OUTPUT_TOGGLE = "hot-key-defintion"
Defines a hot-key sequence which, when pressed by the watcher, causes
output going to the terminal being watched to cease being displayed
on that terminal. The output does, however, continue to go to the
watcher's terminal, only.
This allows one to watch output to a terminal despite it having gone
into an XOFF state due to being put on hold-screen. This is particu-
larly useful for watching disconnected sessions on a terminal server,
which would otherwise be hung, waiting to be reconnected to a
physical terminal.
It can also be useful when watching a terminal on a slow modem line as
one does not have to wait while the output goes out over the modem.
The logical WATCHER$BYPASS_OUTPUT defines the default hot-key value.
A user can disable this feature when he issues a PEEK/ALLOW command
to allow a non-privileged user to watch him. See the top-level PEEK
Subtopic: Commands ALLOW /BP_OUTPUT.
Caution should be used when enabling BYPASS_OUTPUT as it may violate
the security standards at your installation. However, BYPASS_OUTPUT
may be turned off on a per-user or system-wide basis by defining
the logical WATCHER$BP_OUTPUT as FALSE in the appropriate logical
name table. See the top-level PEEK Subtopic: Defaults.
Example:
$ PEEK/BYPASS_OUTPUT_TOGGLE="<CTRL-K>" USER1
or
$ DEFINE WATCHER$BYPASS_OUTPUT_TOGGLE "<CTRL-K>"
$ PEEK USER1
In either case when the watcher presses Control-K, Peek/Spy will cause
output to the terminal of the person being watched to cease going to
that terminal, but to go only to the watcher's terminal instead. This
cessation of output to the watched terminal continues until Control-K
is pressed a second time.
For a complete description of the syntax used for specifying hot-key
definitions, see the top-level PEEK Subtopic: Hot-Keys.
When the BYPASS_OUTPUT feature is used while watching a MultiSessions
terminal (or a terminal on which the PEEK_ONLY screen-saver has been
activated), output which has been sent to the terminal prior to
invoking BYPASS_OUTPUT will not be seen until some new non-broadcast
output is sent to the terminal. This may be done by the watcher if he
has keyboard control of the user's process (see the PEEK Watching
Subtopics: /TOGGLE_INPUT and /SIMULTANEOUS_INPUT).