ADDRESS GLV Commands › ADDRESS GLV Command Descriptions › LISTV Command

LISTV Command

The LISTV command places the name and value of any variable, that is, any status or GLV variable whether volatile or nonvolatile, into a REXX variable.

This command has the following format:

ADDRESS GLV '[SELECT vargroup] LISTV rexxstem [varname . . .] '

SELECT

(Optional) Specifies the name of a variable group (vargroup) to which the specified variable (varname) belongs.

For more information, see the description of the SELECT command.

rexxstem

Specifies the name of the REXX stem variable that will contain the return information for the command.

varname

(Optional) Specifies the name of the variable whose name and value you want to place into the selected stem variable. You can specify one or more varname variable names.

The following wildcard characters are valid for variable name masking:

? or +

Replaces individual characters.

*

Replaces any number of trailing characters when placed as the last character in the name mask.

If you do not specify a varname value, the LIST command writes all variables (in the selected or default variable group) to the selected stem variable.

Example:

The following REXX example places the name and value of the variable(s) starting with D into the REXX variable:

ADDRESS GLV 'SELECT UNNAMED LISTV REXXSTEM D*'
say 'These are all the variables in the UNNAMED group that start with "D":'
do i=1 to rexxstem.0
   say rexxstem.i 
end