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.