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.