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

ENVL[IST]

MPE documents

Complete PDF
Table of Contents
Index

E0201 Edition 4 ♥
E0300 Edition 3
E0692 Edition 3

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                : SADDR = SADDR $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




ENV


ERR