Command Line Overview [ System Debug Reference Manual ] MPE/iX 5.0 Documentation
System Debug Reference Manual
Command Line Overview
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 >
MPE/iX 5.0 Documentation