VMS Help  —  PEEK  Watching  Qualifiers  /TOGGLE_INPUT
   /TOGGLE_INPUT = "hot-key-defintion"
   /NOTOGGLE_INPUT

   Defines a hot-key sequence which will toggle control of the keyboard
   of the user being watched between the user and the watcher.

   If this command qualifier is NOT specified (either on the command
   line or as a WATCHER$TOGGLE_INPUT logical), then the watcher will
   not be able to enter any input for the user unless /SIMULTANEOUS_INPUT
   is in effect.

   If SIMULTANEOUS_INPUT has been specified, pressing the TOGGLE_INPUT
   hot-key will have no effect on the user being watched, but will toggle
   on and off the watcher's ability to type for the user.

     NOTE:  There is a licensing option which will prevent the
     watcher from ever providing input to the user's terminal,
     for use in banking and other high-security environments.

     Thus if the TOGGLE_INPUT feature appears not to work
     for your site, you should check to see if your license
     specifies NOKB_CONTROL.

   The rest of this section will assume that SIMULTANEOUS_INPUT has not
   been specified.

   When PEEK is run, at first the watcher is not allowed to enter input
   to the user's process. If he types anything other than one of his
   hot-key sequences, then PEEK will throw the watcher's attempted input
   away and just ring the bell on his terminal instead.

   The watcher may press TOGGLE_INPUT to switch 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 his defined hot-key sequences. (For defining
   hot-keys for use when being watched, see the top-level PEEK Subtopic:
   Commands ALLOW.)

   Example:

         $ PEEK/TOGGLE_INPUT="<F10>" USER1
     or
         $ DEFINE WATCHER$TOGGLE_INPUT "<F10>"
         $ PEEK USER1

   In this case, if the watcher presses F10 while watching, then he will
   take over keyboard control from USER1 (or give it back, if he already
   has control of the USER1's keyboard).

   For a complete description of the syntax used for specifying hot-key
   definitions, see the top-level PEEK Subtopic: Hot-Keys.

   If you don't want a TOGGLE_INPUT hot-key defined then /NOTOGGLE_INPUT
   may be used to override the existence of a default TOGGLE_INPUT hot-key.

   NOTE:  Use of the /NOTOGGLE_INPUT qualifier means there will be no
          TOGGLE_INPUT hot-key defined for whoever issues the command
          containing the /NOTOGGLE_INPUT. The PEEK ALLOW-command's
          /NOKB_CONTROL qualifier refers to whether an ALLOWed watcher
          will be able to have keyboard control.
Close Help