/TOGGLE_INPUT = "hot-key-defintion" /NOTOGGLE_INPUT Defines a hot-key sequence for use while being watched which, when pressed, switches control of the user's keyboard between the watcher and the user. If a watcher has taken control of the user's keyboard with PEEK, then when this hot-key is pressed by the user, it returns control of his keyboard back to him/her. The default value for this hot-key is taken from the logical USER$TOGGLE_INPUT, usually defined by PEEK_DFAULTS.COM. If SIMULTANEOUS_INPUT is in effect, both the watcher and the user will be able to provide input for the user at the same time. Pressing the TOGGLE_INPUT hot-key has no effect in this case. If this hot-key is NOT defined (either on the command line or as a logical name) then the user will not be able to regain keyboard control once it has been taken over by a watcher. NOTE: There is a licensing option which will prevent the watcher from ever providing input to the user's terminal. This is for use in banking and other high-security environments. If the TOGGLE_INPUT feature appears not to work at your site, you should check to see if your license specifies NOKB_CONTROL. Use the $ PEEK/SHOW LICENSE command to check your license options. The remainder of this section will assume that SIMULTANEOUS_INPUT is not in effect. When a watcher first begins watching someone, the watcher is not allowed to enter input for the user's process. If he types anything (other than one of his defined hot-key sequences) PEEK throws away the watcher's input and rings the bell on his terminal to remind him that he does not currently have keyboard control. The watcher may press his TOGGLE_INPUT hot-key to swap keyboard control, taking it away from the user being watched. At this point, the bell on the terminal of the user being watched will ring if he attempts to type anything other than his defined hot-key sequences. The user being watched may then press his own TOGGLE_INPUT hot-key sequence to get control of his keyboard back from the watcher. For example, J_DOE issues the command: $ PEEK/ALLOW/TOGGLE_INPUT="<F10>" USER1 After this ALLOW command is issued, USER1 can watch J_DOE with PEEK. While watching J_DOE, USER1 can press his hot-key to take over keyboard control from J_DOE. If J_DOE then tries to type, his terminal bell will just ring to inform him that USER1 currently has keyboard control. J_DOE can then press his F10 key to regain control of his keyboard. For a complete description of the syntax used for specifying hot-key definitions, see the top-level PEEK Subtopic: Hot-Keys. The /TOGGLE_INPUT command qualifier may also be negated. This allows one to override a default TOGGLE_INPUT definition which has been placed in a logical name table. When specified as PEEK/ALLOW/NOTOGGLE_INPUT, this tells PEEK no hot-key should be defined to allow the user to toggle input control while being watched. /NOTOGGLE_INPUT is equivalent to specifying /TOGGLE_INPUT="" (null string). NOTE: The ALLOW/NOTOGGLE_INPUT qualifier prevents a user who issues the command containing it from toggling keyboard input. The ALLOW/NOKB_CONTROL qualifier refers to whether an ALLOWed watcher may take over control of the keyboard of the user being watched.