ADDRESS REXXTOOL

Syntax:

ADDRESS REXXTOOL [command]

Commands:

REXXTOOL commands. See Service Description below.

Module Name:

SWXARXT

Service Description:

ADDRESS REXXTOOL is a host command environment. As with other host command environments, you switch to the REXXTOOL host command environment using the ADDRESS instruction. To send a command to the host command environment you simply embed a command string in your program.

The host commands supported by ADDRESS REXXTOOL are:

ALLOCATE: A host command for allocating data sets.
FREE: A host command for freeing previously allocated data sets.
OPTIONS: A host command for setting product options.
VERASE: A host command for removing variables from a Shadow REXXTOOLS variable pool.
VGET: A host command for retrieving the values of variables in a REXXTOOL/MVS variable pool into REXX simple symbols.
VPUT: A host command for copying the values of REXX simple symbols (variables) into a variable pool that is managed by Shadow REXXTOOLS.

Returned Information:

The REXXTOOL host command environment, like other REXX host command environments, returns a return code in the special variable RC. Certain RC values are common to all REXXTOOL host commands. These are as follows:

-7: Syntax error. Refer to command documentation for the correct syntax.
-6: Invalid keyword. Refer to command documentation.
-5: Command verb not recognized. Verify that you have sent the command to the proper host command environment.
-4: Zero length command string was passed.
-3: REXXTOOL host command environment not found. This RC is set by REXX (not by Shadow REXXTOOLS) whenever REXX is unsuccessful in locating a host command entry in the host command table of the current REXX environment.
0: Successful execution.

Positive integer return codes are specific to the command that is being executed. Refer to the command documentation for these RC values.

Note: Other information may also be returned by REXXTOOL commands. Refer to the command documentation for descriptions of returned information.

Examples:

Execute a VPUT command:

namestr = "wanda rosalie brian richard earl"
address rexxtool "vput (namestr) shared"

Allocate a data set to file IN:

address rexxtool
"alloc fi(in) da(mydata) shr reuse"