NET/MASTER Management Services (MS) Command Reference Manual

DEBUG START
NonStop NET/MASTER MS Commands
115412 Tandem Computers Incorporated 2–61
DEBUG START The DEBUG START command starts a single debug session. This must be the first
DEBUG command you enter; it initiates the session. No other DEBUG commands can
be successfully executed unless you start a debug session first. Contrast this command
with the DEBUG STOP command, which stops a debug session.
Before you can begin debugging, you need to set the current NCL process. You can do
this by:
Specifying the ID operand in the DEBUG START command
Using the DEBUG SET command
Accepting the default NCL ID
A given environment or a given NCL process can be marked as being debugged by
only one debug session at a time. If you want to start a debug session for an
environment that you do not own or an NCL process that was started by another user,
your command authority level must be equal to or greater than the default authority
level of 2. Multiple DEBUG START commands start multiple concurrent debug
sessions.
Entering the DEBUG START command with no operands marks your current
execution environment—normally the primary processing environment associated
with your current OCS window at your current terminal—as being debugged.
DEBUG START [ ID= ncl-id |
[ ENV={ ALL | CURRENT | DEPENDENT } ]
[ PROCS={ ALLPROCS | CURRPROCS | NEWPROCS } ]
[ TERM={ device-name | logical-name } ]
[ USER= user-id ]
[ WINDOW= window-number ] ]
ID= ncl-id
specifies the NCL process identifier (NCL ID) of an NCL process and sets the
current NCL process. If no NCL ID is specified, the first procedure that is
debugged sets the NCL ID automatically. Once set, subsequent DEBUG
commands that omit the ID operand default to the NCL process currently being
debugged. This NCL ID remains as the default until another NCL ID is specified
or the current debug session has ended.
The specified NCL process is marked as being debugged. The environment in
which it is executing is not marked as being debugged.
ENV
specifies the environment targeted by the DEBUG START command.