VERASE Command

Syntax:

VERASE (varname[,varname...])  [varpool]

Arguments:

varname: The name of a variable to remove from the Shadow REXXTOOLS shared variable pool. The REXX variable of the same name (whether or not it exists) is unchanged. Only simple variables whose names are 1 to 8 characters in length are permitted. REXX stem variables are not supported.
Note: You may use one or more blanks between syntactical elements in the VERASE command. Also, you may use blanks instead of commas to separate variable names.
varpool: The name of the variable pool. At present, the only valid variable pool is SHARED.

Module Name:

SWXARXT

Service Description:

VERASE is a host command that is executed under the REXXTOOL host command environment. VERASE is used to remove variables from the Shadow REXXTOOLS shared variable pool. The shared variable pool is available to all REXX programs that execute under the same MVS task. Shared variables are kept in main storage until they are VERASEd or until the task terminates.

Returned Information:

The VERASE command returns a return code in the REXX RC variable. Some return codes are common to all REXXTOOL host commands. These are documented under the topic "ADDRESS REXXTOOL". In addition, the VERASE command produces the following RC values:

0: Successful execution. All variable names were found in the Shadow REXXTOOLS shared variable pool and removed.
8: At least one varname was not found in the Shadow REXXTOOLS shared variable pool. Those variables that were found were removed.

Examples:

Remove 2 variables from the Shadow REXXTOOLS shared variable pool:
```
address rexxtool "verase (name address)"
```
In this example note that the comma between NAME and ADDRESS is omitted, as is the SHARED keyword.