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.