SHOWVAR

Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004

Back to Main Index


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)

Back to Main Index