IBM TSO/E REXX User Manual

Using the MVSVAR Function
The MVSVAR function retrieves information about MVS, TSO/E, and the current
session, such as the symbolic name of the MVS system, or the security label of the
TSO/E session. The information retrieved depends on the argument specified.
To retrieve the information, use the MVSVAR function immediately followed by an
argument value enclosed in parentheses. For example, to find out the APPC/MVS
logical unit (LU) name, use the MVSVAR function with the argument SYSAPPCLU.
appclu = MVSVAR('SYSAPPCLU')
The MVSVAR function is available in any MVS address space. Compare this to
the SYSVAR function which also retrieves system information but can only be used
in REXX execs that run in the TSO/E address space.
Many of the MVSVAR arguments retrieve the same information as do CLIST control
variables.
The following table lists the items of information that are available for retrieval by
MVSVAR.
Argument Value Description
SYSAPPCLU the APPC/MVS logical unit (LU) name
SYSDFP the level of MVS/Data Facility Product (MVS/DFP)
SYSMVS the level of the base control program (BCP) component of
z/OS
SYSNAME the name of the system your REXX exec is running on, as
specified in the SYSNAME statement in SYS1.PARMLIB
member IEASYSxx
SYSSECLAB the security label (SECLABEL) name of the TSO/E session
SYSSMFID identification of the system on which System Management
Facilities (SMF) is active
SYSSMS indicator whether DFSMS/MVS is available to your REXX
exec
SYSCLONE MVS system symbol representing its system name
SYSPLEX the MVS sysplex name as found in the COUPLExx or
LOADxx member of SYS1.PARMLIB
SYMDEF symbolic variables of your MVS system
Using the OUTTRAP Function
The OUTTRAP function puts lines of command output into a series of numbered
variables, each with the same prefix. These variables save the command output
and allow an exec to process the output. Specify the variable name in parentheses
following the function call.
SAY 'The OUTTRAP variable name is' OUTTRAP('var')
/* Displays the variable name in which command output is trapped. */
In this example, the variable var becomes the prefix for the numbered series of
variables. Var1, var2, var3, and so on, receive a line of output each. If you do not
set a limit to the number of output lines, the numbering of variables continues as
TSO/E External Functions
Chapter 10. Using TSO/E External Functions 123

IBM TSO/E REXX Specifications

General

Brand	IBM
Model	TSO/E REXX
Category	Computer Hardware
Language	English