VPUT Command

Syntax:

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

Arguments:

varname
The name (not the value) of a REXX simple variable to copy from the REXX variable pool to the Shadow REXXTOOLS shared variable pool. The REXX variable itself is unchanged. The name of the variable in the Shadow REXXTOOLS shared variable pool is identical to the name of the REXX variable. Only simple variables whose names are 1 to 8 characters in length are permitted. REXX stem variables are not supported.

Notes:

  1. Whenever an uninitialized REXX variable is encountered, the variable's name is used for its value.
  2. You may use one or more blanks between syntactical elements in the VPUT 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:

VPUT is a host command that is executed under the REXXTOOL host command environment. VPUT is used to copy the current values of REXX variables into 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 VPUT 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 the absence of any syntax errors, the VPUT command only returns zero, which indicates successful execution.

Examples:

  1. VPUT 4 variables into the Shadow REXXTOOLS shared variable pool:
    address rexxtool
    "vput (name,address,phone,amount) shared"
    


© Copyright 1998 by Open Software Technologies, Inc.