NET/MASTER Management Services (MS) Command Reference Manual

DEBUG TRACE
NonStop NET/MASTER MS Commands
115412 Tandem Computers Incorporated 2–73
DEBUG TRACE The DEBUG TRACE command obtains stack trace information from the targeted NCL
process. Each message line displayed by this command represents a nesting level
resulting from calling a procedure or function, a subroutine, or an error handler, and
displays information about that nesting level.
DEBUG TRACE [ ID= ncl-id ]
[ ARGS={ YES | NO } ]
ID= ncl-id
specifies the NCL process identifier (NCL ID) of an NCL process and sets the
current NCL process. If you do not specify an NCL ID, the default NCL ID is
assumed (see the DEBUG START command for further information about the
default NCL ID).
ARGS
specifies whether to list the current values of the parameter variables &1 through
&n.
Note The values displayed by the ARGS operand are not necessarily the original values passed to the current
procedure or function.
YES
lists the current values of the parameter variables &1 through &n.
NO
does not list the current values of the parameter variables &1 through &n.
Considerations
The default authority level of this command is 0.
You can enter this command from any NCL procedure, except the INIT NCL
procedure, by using either the CMD core statement or the INTCMD verb.
Messages NNM1929 through NNM1931, NNM1940, and NNM0999 indicate the
results of this command. Refer to the NonStop NET/MASTER Messages Manual or
NonStop NET/MASTER MS online help for a description of these messages.
In certain situations, statement position information is unavailable. This can
occur, for example, when an error is raised that is not handled by an error handler
but a termination breakpoint is set. In this case, the statement position is replaced
by a hyphen (-), and the line information is replaced by a hyphen (-). This occurs
only when the scope is zero because any execution attempt terminates the NCL
process.