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