HPlogo System Debug Reference Manual > Chapter 4 System Debug Command Specifications

CMDL[IST]

MPE documents

Complete PDF
Table of Contents
Index

E0201 Edition 4 ♥
E0300 Edition 3
E0692 Edition 3

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




CM


CMG