HELPLIB.HLB  —  PEEK  Commands  /COMMAND_MODE
   Command mode allows subcommands to be issued as verbs instead of
   as command qualifiers.

   As shipped, command mode is the default mode used during Peek/Spy
   interactive command prompting, and non-command mode is used for
   single-line DCL Peek/Spy commands.

   As shipped:

     In single-line DCL commands, subcommands are qualifiers:

       $ PEEK /ALLOW PETE      ! Allow PETE to watch you.
       $ PEEK /SHOW  USERS     ! Show users on system.
       $ PEEK JOE              ! Watch process JOE.

     During interactive command-prompting, subcommands are verbs:

       $ PEEK                  ! Enter command-prompting mode.
       PEEK> ALLOW PETE        ! Allow PETE to watch you.
       PEEK> SHOW  USERS       ! Show users on system.
       PEEK> WATCH JOE         ! Watch process JOE.

   The subcommands which are accepted as verbs in command mode are:

   ALLOW, ATTACH, DISALLOW, EXIT, FORMAT, HELP, LICENSE,
   NODE_NAME_CHANGE, NOSAVE_SCREEN, PEEK (for PEEK), QUIT,
   RT_ENABLE (VAX-only), SAVE_SCREEN, SHOW, SHUTDOWN, SPAWN,
   SPY (for SPY), and WATCH.

   When in command mode, you must use the WATCH (or PEEK for Peek,
   or SPY for Spy) verb when you want to watch someone. E.g.

     PEEK> WATCH JOE        ! Not  PEEK> JOE.

   The qualifier form of all the above subcommands is also still accepted
   when in command mode, e.g. "PEEK> /WATCH JOE" is accepted.

1  –  Disabling Command Mode

   If desired, you can disable command mode, so subcommands must always
   be entered as command qualifiers, even during interacive command
   prompting.

   To disable command mode during Peek/Spy command prompting, define
   the logical name WATCHER$COMMAND_MODE_PROMPT as False.

   This logical name can be defined system-wide by PEEK_DEFAULTS.COM,
   or it can be locally defined in any of the logical-name tables
   specified by LNM$PEEK_TABLE_SEARCH_LIST, which is defined by
   PEEK_DEFAULTS.COM.

   When WATCHER$COMMAND_MODE_PROMPT is FALSE, subcommands must always
   be entered as command qualifiers, even during command prompting.

   Example:  $ PEEK
             PEEK> /ALLOW JOE    ! Not  PEEK> ALLOW JOE
             PEEK> /WATCH *      ! Not  PEEK> WATCH *

2  –  Forcing Command Mode

   The /COMMAND_MODE qualifier can be used to force command-mode.

   After entering the /COMMAND_MODE qualifier, you will not need to
   use a slash on the command line, but can enter the various
   subcommands as verbs.

   You can force command-mode syntax, even for single-line DCL
   Peek/Spy commands by changing the Peek/Spy foreign command
   defintions to include the /COMMAND_MODE qualifier.

   Change the DCL definitions of the PEEK and SPY symbols from:
   (The _Vx should be replaced with _V5 or _V6 or _V7.)

     $ PEEK :== $ PEEK$LOCATION:PEEK_Vx
     $ SPY  :== $ PEEK$LOCATION:SPY_Vx
   to
     $ PEEK :== $ PEEK$LOCATION:PEEK_Vx/COMMNAD_MODE
     $ SPY  :== $ PEEK$LOCATION:SPY_Vx/COMMAND_MODE

   Once the PEEK and SPY symbols are so defined, Peek/Spy
   subcommands may be used as verbs in single-line DCL commands.

   Example:

         $ PEEK ALLOW JOE     ! Instead of $ PEEK /ALLOW JOE.
         $ PEEK WATCH *       ! Instead of $ PEEK /WATCH *.

   Note that in command mode, the WATCH verb is required.
   Wrong in command mode:

        $ PEEK JOE            ! Not accepted in command mode.

   Right in command mode:

        $ PEEK WATCH JOE      ! WATCH verb is required syntax.
Close Help