Visara Master Console Center Scripting Guide - Manual (Page 229)

Chapter 6 Obsolete Material
Scripting Guide 229
TSOEREXX
Syntax:
TSOEREXX( %ObjID, $CmdArray, %ErrorArray, $ErrorTextArray)
==> %ReturnValue
Description:
Enters commands to TSO/E REXX using the GW-MVS agent.
Action:
The commands in the $CmdArray parameter are issued to the OS
(LPAR) referenced by the %ObjID parameter.
Parameters: %ObjID. Numeric expression. The object identifier. The unique ID of
the OS to which to send the commands. Refer to Object ID on page 26
for more information.
$CmdArray. Normal string array. The array of TSO/E REXX
commands to launch on the target OS.
Note: Each command string must be less than seventy (70) characters
in length.
%ErrorArray. Normal integer array. Each command in $CmdArray
has a corresponding element in %ErrorArray indicating the error
status of that command. A value of zero (0) indicates successful
submission to the host.
Note: A success (0) situation does not necessarily guarantee successful
processing. The command may have been submitted successfully, but
the action could not be completed on the host for any number of
reasons. Use the QREAD() command to verify the outcome of a
submitted command from that command’s output.
$ErrorTextArray. Normal string array. Each command in the
$CmdArray has a corresponding string in $ErrorTextArray. Each
entry gives diagnostic information indicative of any problems that may
have occurred while submitting the command to the host.
Returns:
Numeric value as follows:
Value
Status
0 Indicates the host agent successfully processed all
commands
-1 Symbolic ERROR indicating there was a problem
If an ERROR occurs, each %ErrorArray element must be checked to
identify which commands were not successfully submitted.
Notes:
1. TSOEREXX requires the optional MCC to GW-MVS interface, and
the installation of the GW-MVS agent on each LPAR with which to
communicate.
2. For information on error checking of TSOEREXX, refer to the
description of the ERRORNUM() command.