HP 3000 Manuals

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