|
|
System Debug displays a prompt when it is ready to accept
a command interactively. The standard prompt looks like this:
$10 ($42) nmdebug >
The first number is the current command number. This is the
number that is assigned to the command entered at the prompt. Blank
lines do not cause the command number to increase. The number in
parentheses is the process identification number (PIN) of the current
process. If Debug is entered from the CI, then this is the CI's PIN.
The dollar signs in front of the numbers indicate that the
current output radix is hexadecimal. Except for a few obvious exceptions,
most numbers are displayed in the current output base. The abbreviations
for numeric radices are
% - octal, # - decimal, $ - hexadecimal.
The nmdebug > part of the prompt is composed of two parts. The
first, nm, indicates that the current mode of System Debug
is native mode. The other possibility is cm for compatibility mode.
The second part, debug, identifies the name of the tool being run.
Another possibility for this is dat.
The prompt can be changed with the ENV command as follows:
$10 ($42) nmdebug > env prompt "mode ' > '"
nm >
Command names can be entered in either upper- or lowercase
and may be followed by their parameters, separated from one another
by either blanks or commas. The specifications of individual commands
may also describe special parameters that are also accepted.
Comments can be entered on any command line, and are introduced by the sequence
/*. Everything on a command line after the /* is ignored:
CMD1 parm1 /* this is a comment...
Long commands may be spread across several lines by using the command
continuation character "&". Command lines ending with this
character are continued on the following line. The special prompt
cont > is used to indicate that command continuation is in progress:
$nmdebug > wl 'This is a long &
cont > line broken into&
cont > three parts.'
This is a long line broken into three parts.
$nmdebug >
The semicolon separates multiple commands entered on the same line:
CMD1; CMD2; CMD3; ...
A command list can be formed by enclosing multiple commands
within curly braces. Command lists are syntactically single commands,
and are frequently used as command parameters:
b myproc, 1,, {CMD1; CMD2; CMD3}
Unterminated command lists, which are introduced with a left
curly brace, can be continued on successive input lines without
the use of the command continuation character. The command prompt
changes to indicate that a multiline command list is being read,
and it displays the current nesting level of the braces. When the
final closing right brace is encountered, the prompt changes back
to the normal command line prompt:
$nmdebug > if p1 > 0 then {
{$1} multi > wl "parm is:" p1;
{$1} multi > var curbias = p1+bias}
$nmdebug >
|