VMS Help  —  KCAP  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 KeyCapture
   interactive command prompting, and non-command mode is used for
   single-line DCL KeyCapture commands.

   As shipped:

     In single-line DCL commands, subcommands are qualifiers:

       $ KCAP /TRACK           ! Start KeyCapture for the current terminal.
       $ KCAP /SHOW VERSION    ! Show the version of KeyCapture.

     During interactive command-prompting, subcommands are verbs:

       $ KCAP                  ! Enter command-prompting mode.
       KCAP> TRACK             ! Start KeyCapture for the current terminal.
       KCAP> SHOW VERSION      ! Show version of KeyCapture.
       KCAP> SPAWN             ! Spawn a subprocess.

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

   ATTACH, EXIT, FORMAT, HELP, LICENSE, NODE_NAME_CHANGE, NOTRACK, QUIT,
   SHOW, SHUTDOWN, SPAWN and TRACK.

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

1  –  Disabling Command Mode

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

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

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

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

   Example:  $ KCAP
             KCAP> /TRACK        ! Not  KCAP> TRACK
             KCAP> /SHOW         ! Not  KCAP> SHOW

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
   KeyCapture commands by changing the KeyCapture foreign command
   definitions to include the /COMMAND_MODE qualifier.

   Change the DCL definitions of the KCAP symbol from:
   (The _Vx should be replaced with _V5 or _V6 or _V7.)

     $ KCAP :== $ KCAP$LOCATION:KCAP_Vx
   to
     $ KCAP :== $ KCAP$LOCATION:KCAP_Vx/COMMNAD_MODE

   Once the KCAP symbol is so defined, KeyCapture
   subcommands may be used as verbs in single-line DCL commands.

   Example:

         $ KCAP TRACK      ! Instead of $ KCAP /TRACK.
         $ KCAP SHOW       ! Instead of $ KCAP /SHOW.
Close Help