System Debug displays a prompt when it is ready to accept a command interactively.
The standard prompt looks like this:
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:
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 >
|