CMDL[IST] [ System Debug Reference Manual ] MPE/iX 5.0 Documentation
System Debug Reference Manual
CMDL[IST]
Command list. Displays a list of the valid commands for System Debug.
Syntax
CMDL[IST] [pattern] [group] [options]
This command displays a list of valid commands for System Debug. Several
System Debug commands are actually implemented as aliases. Aliases are
not displayed with the CMDL command; rather, the ALIASL command must be
used to view them.
Parameters
pattern The command name(s) to be displayed.
This parameter can be specified with wildcards or with a
full regular expression. Refer to appendix A for
additional information about pattern matching and
regular expressions.
The following wildcards are supported:
@ Matches any character(s).
? Matches any alphabetic character.
# Matches any numeric character.
The following are valid name pattern specifications:
@ Matches everything; all names.
pib@ Matches all names that start with "pib".
log2##4 Matches "log2004", "log2754".
The following regular expressions are equivalent to the
patterns with wildcards that are listed above:
`.*`
`pib.*`
`log2[0-9][0-9]4`
By default, all command names are listed.
group Commands are logically organized in groups. When
listed, the commands can be filtered by group, that is,
only those commands in the specified group are
displayed.
PROCESS Process control
BREAK Breakpoint setting/listing/deleting
DISPLAY Display memory/code/segments
OBJECTS File mapping, Object freezing
REGISTER Display/modification/listing of
registers
STACK Stack tracing, level switching
MODIFY Modify memory/code/segments
SYMBOLIC Symbolic file access
VAR Variable definition/listing/deleting
MACRO Macro definition/listing
FUNC Predefined function information
ENV Commands to list/show/alter the
environment
TRANSLATE Translate CM addresses to NM address
CI Command Interpreter-related
IO For producing I/O
DUMP Open/close/purge/info on dumps
ERROR Error management
MISC Grab bag
WINDOW Window related
ALL | @ All groups
options Any number of the following options can be specified in
any order, separated by blanks or commas:
NAME Display command name only (default).
USE Display command syntax, and summary
of use.
NOUSE Skip the syntax/summary.
PARMS Display parameter names and types.
NOPARMS Skip parameter display.
DESC Display a general description.
NODESC Skip the description.
EXAMPLE Display an example.
NOEXAMPLE Skip the example.
ALL | @ Display everything. Same as:
NAME USE PARMS DESC EXAMPLE
PAGE Page eject after each command
definition. Useful for paged
(listfile) output.
NOPAGE No special page ejects. (default)
If none of the options above are specified, NAME is
displayed by default. If any options are specified,
then they are accumulated to describe which fields are
printed.
Examples
$nmdat > cmdl ,err
cmd ERR error nm cm
cmd ERRD error nm cm
cmd ERRL error nm cm
cmd IGNORE error nm cm
Type "WHELP" for a list of the window commands
Type "ALIASL" for a list of the command aliases
List all of the commands that deal with error management.
$nmdat > cmdl w@
cmd W io nm cm
cmd WCOL io nm cm
cmd WHELP window nm cm
cmd WHILE ci nm cm
cmd WL io nm cm
cmd WP io nm cm
cmd WPAGE io nm cm
List all of the commands that start with the letter "W".
$nmdat > cmdl w@,ci
cmd WHILE ci nm cm
List all of the commands that start with the letter "W" and deal with
System Debug's command interpreter. There is only one such command,
WHILE.
$nmdat > cmdl while,,all
cmd WHILE ci nm cm
USE:
WHILE condition DO command | {cmdlist}
PARMS:
condition A logical expression to be repeatedly evaluated.
command A single command to be executed while CONDITION is true.
cmdlist A list of commands to be executed while CONDITION is true.
DESC:
The WHILE command evaluates a logical expression and, if TRUE, executes
a command/command list. The expression is then reevaluated, and the
process continues until the expression is FALSE.
EXAMPLE:
$nmdebug > while [pc] >> $10 <> $2000 do ss
<Single step until the next Pascal statement number>
Provide all information available for the WHILE command.
$nmdat > cmdl while,,all noexample nodesc
cmd CMDL ci nm cm
USE:
WHILE condition DO command | {cmdlist}
PARMS:
condition A logical expression to be repeatedly evaluated.
command A single command to be executed while CONDITION is true.
cmdlist A list of commands to be executed while CONDITION is true.
Provide all information available for the WHILE command except examples
and description.
Limitations, Restrictions
none
CAUTION The output format of all System Debug commands is subject to
change without notice. Programs that are developed to
postprocess System Debug output should not depend on the exact
format (spacing, alignment, number of lines, uppercase or
lowercase, or spelling) of any System Debug command output.
MPE/iX 5.0 Documentation