# 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:

1. Execute a VPUT command:

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

2. Allocate a data set to file IN:

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

© Copyright 1998 by Open Software Technologies, Inc.