HP 3000 Manuals

ENVL[IST] [ System Debug Reference Manual ] MPE/iX 5.0 Documentation


System Debug Reference Manual

ENVL[IST] 

Displays the current values for environment variables.

Syntax 

     ENVL[IST] [pattern] [group] [options]

Parameters 

 pattern         The name of the environment variable(s) to be listed.

                 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", and so on.

                 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 variables are listed.

 group           The environment variables are logically organized in
                 groups.  When listed, the variables can be filtered by
                 group; that is, only those variables in the specified
                 group is displayed.

                 CONST            Predefined constants
                 CMD              Command-related
                 IO               Input/output-related
                 MISC             Miscellaneous
                 WIN              Window
                 SYSTEM           System-wide Debug registers

                 C*EG             Compatibility mode registers
                 N*EG             Native mode registers
                 FPREG            Native mode floating-point registers

                 STATE            Same as C*EG N*EG FPREG
                 NOSTATE          Same as CONST CMD IO MISC WIN SYSTEM
                                  (default)

                 ALL | @          All groups

                 If the group name is omitted, NOSTATE is used by
                 default.

 options         Any number of the following options can be specified in
                 any order, separated by blanks:

                 NAME             Display variable name only
                 USE              Display a one-line summary
                 NOUSE            Skip the summary
                 DESC             Display a general description
                 NODESC           Skip the description
                 EXAMPLE          Display an example
                 NOEXAMPLE        Skip the example
                 ALL | @          Display everything, Same as:
                                  NAME USE DESC EXAMPLE

                 If none of the options above are specified, NAME is
                 displayed by default.  If any options are specified,
                 they are accumulated to describe which fields are
                 printed.

Examples 

     $nmdat > envl, win 
     win     rw    CHANGES           : STR   = 'HALFINV'
     win     r     CMPW              : LCPTR = SYS $15.0
     win     r     LW                : LPTR  = $1.0
     win     rw    MARKERS           : STR   = 'ULINE'
     win     r     NMPW              : LCPTR = SYS $a.702d6c
     win     r     PW                : LCPTR = SYS $a.702d6c
     win     r     PWO               : SPTR  = $00702d6c
     win     r     PWS               : U32   = $a
     win     rw    SHOW_CCTL         : BOOL  = FALSE
     win     r     VW                : LPTR  = $0.0
     win     r     VWO               : SPTR  = $00000000
     win     r     VWS               : U32   = $0
     win     r     ZW                : U32   = $0

Display all window-related environment variables.

     $nmdat > envl m@ 
     cmd     r     MACRO_DEPTH       : U16   = $0
     win     rw    MARKERS           : STR   = 'ULINE'
     misc    r     MODE              : STR   = 'nm'
     cmd     rw    MULTI_LINE_ERRS   : U16   = $2

Display all environment variables that begin with the letter "m".

     $nmdat > envl vw,,all 
     win     r     VW                : LPTR  = $0.0

     DESC:

     The virtual address where the current virtual window is aimed.

Display the environment variable VW and all related information
associated with that variable.

     $nmdat > env term_loud 0 
     $nmdat > list envinfo 
     $nmdat > envl @,,all page 
     $nmdat > list close 
     $nmdat > env term_loud 1 

Create a list file with complete information on all of the environment
variables.  The list file is paged with one environment variable
description per page.

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