Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004
Displays specific variable names and their current values.
SHOWVAR [varid][,varid]...[,varid] [job= jobID ] [;USER | HP | ANY]
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.
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.
SHOWVAR firstvariable, secondvariable Displays two specific variables. SHOWVAR ?axval Displays all variables beginning with a single alphabetic character and ending with the characters axval.
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.
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