SHOWVAR


SHOWVAR

     Displays specific variable names and their current values.

SYNTAX


SHOWVAR [varid][,varid]...[,varid]
[JOB= jobID ]
[;USER | HP | ANY]


PARAMETERS


varid The name of the variable for which the current value
is to be displayed.

jobid The job or session number who's variables are to be
displayed. Example: #J123 or S4321. SM capability
is required to see the variables from another job or
session. Only user-defined variables are visible
when "jobID" is specified. It is recommended to
always specify the USER option when using JOB=. This
adds clarity to scripts and job streams, and
preserves their functionality should JOB= be
enhanced to display predefined variables.

USER Selects only the user-defined variables matching
each "varid". USER is the default when "varid" is
omitted. It is recommended to use USER in
conjunction with JOB=, see the note above.

HP Selects only the predefined HP variables matching
each "varid".

ANY Allows all variables matching "varid" to be seen.
ANY is the default when one or more "varid"s are
supplied, as long as "jobid" is not specified.


OPERATION

     This command displays to $STDLIST the variables specified and their
values. It displays information in the format:

VARIABLE_NAME = value

Users with SM capability may display user-defined variables for
another job or session by using the JOB= parameter. If "jobid"
matches the job ID of the user executing the command no
restrictions are placed. Please specify the USER option in scripts
and jobs that use JOB=. This documents the intent, and allows
these scripts and jobs to function the same if JOB= is later
enhanced to show predefined and user-defined variables.

Anyone can specify the USER, HP and ANY options. However, an error
is reported if HP is used in conjunction with a "jobid".

This command may be executed from a job or session, in break or
from a program. Pressing [Break] aborts the execution of this command.


VARIABLE-ID DISPLAYS

(omitted) All user-defined variables

@ All variables

a,b,c Values for variables a, b, and c

B@ All variables whose names begin with B

You may use wild card characters, @, #, ?, and [ ],
to specify a set or range of variables or file names
in many commands.

@ Specifies zero or more alphanumeric
characters, or the underbar character (_).
Used by itself, it specifies all possible
combinations of such characters. Used with
other characters it indicates all the
possible names that include the specified
characters (@ABC@ = all names that include
ABC anywhere in the name).

# Specifies one numeric character. A###@ =
all names that begin with A followed by any
three digits, followed by any combination
of zero to three alphanumeric (or underbar)
characters.

? Specifies one alphanumeric character. A?#
= all three character names that begin with
A, followed by an alphanumeric, followed by
a digit.

[ ] Specifies a set or range of characters.
The set may appear anywhere in the name.
This range specification is not case
sensitive [A-K] is the same as [a-k]. If
you specify a null set such as [k-a], then
MPE/iX warns you that this specification
is invalid.

@[abc]@# = all names containing A, B, or C
and ending in a single digit.

[a-k]@ = all names that begin with any one
of the letters a through k.

[n-a] = is not valid in variable and would
be flagged as an error.

This command may be issued from a session, job, program, or
in BREAK. Pressing [Break] aborts the execution of this command.


EXAMPLE(S)

SHOWVAR firstvariable, secondvariable

Displays two specific variables.

SHOWVAR ?axval

Displays all variables beginning with a single alphabetic
character and ending with the characters axval.

SHOWVAR

Displays all variables created by the user with the SETVAR,
INPUT, or SETJCW command, or with the HPCIPUTVAR, PUTJCW,
or SETJCW intrinsics.

SHOWVAR @

Displays all variables created by the user and all predefined
variables.

SHOWVAR ;job=#s32

Displays all user-defined variables for session 32. Must have SM
capability.

SHOWVAR s@ ;job=J23 ;user

Displays all user-defined variables matching "S@" for job 23. Must
have SM capability.

SHOWVAR h@ ;user

Displays all user-defined variables beginning with the letter "H".
Note: the predefined HP variables, like HPPATH, or not shown.

SHOWVAR @time@ ;hp

Displays all predefined variables containing "TIME" in their names.
User created variables, like MYTIME, would not be seen.

ADDITIONAL INFORMATION

Help    :   Type HELP VARIABLES at the colon (:) prompt, or type
VARIABLES at the Help facility (>) prompt to see a
list of predefined variables.

Commands: SETVAR, INPUT, SHOWJCW, DELETEVAR, ECHO

Manuals : Appendix A, "Predefined Variables in MPE/iX" in the
MPE/iX Commands Reference Manual (32650-90003)