12 Execute REXX Program - ironstream_for_micro_focus_universal_discovery - 7.4

Ironstream for Micro Focus® Universal Discovery for IBM Z® Administration

Product type
Software
Portfolio
Integrate
Product family
Ironstream
Product
Ironstream > Ironstream for Micro Focus® Universal Discovery
Version
7.4
Language
English
Product name
Ironstream for Micro Focus Universal Discovery for IBM Z
Title
Ironstream for Micro Focus® Universal Discovery for IBM Z® Administration
Copyright
2022
First publish date
2007
ft:lastEdition
2023-08-23
ft:lastPublication
2023-08-23T16:22:42.216801

Name

Details

Description

Run the named REXX program. The named program must reside in a dataset identified by the SYSEXEC DD in the VP390 startup JCL.

Parameters

The first parameter is the name of the REXX program to run, followed by any parameters that are to be passed to the REXX program. Separate the program name from the program parameters with a vertical bar and separate the program parameters with white space. Up to 50 program parameters may be specified. Optionally, specify "maxsize=n" as the last parameter to limit then number of bytes of output that are returned. The default maxsize is 5000 bytes.

Output

The value of the REXX return statement will be sent as the output. Normally this will be one line, but multiple lines can be created by inserting carriage return (x'0A') characters into the value that is returned.

Sample Command

The following REXX program is saved as "TEST" in a SYSEXEC DD library:

/* REXX program that accepts two whole numbers and returns */

/* two lines of output: the numbers and the sum of the numbers */ parse upper arg parm1 parm2 .

if DATATYPE(parm1,'W') \= 1 | DATATYPE(parm2,'W') \= 1 then do

n = 'Inputs must be whole numbers' return n

exit end

linefeed = X2C('0A')

n = 'Input numbers:' parm1 parm2 linefeed 'sum is:' parm1 + parm2 return n

exit

Run the program with the parameters "111" and "222" with a maximum output of 6000 bytes. Note that the X2C('0A') function inserts a line break into the output:

ev390hostcmd 46 12\|TEST\|111 222\|maxsize=6000.s390.mysite.com

Sample Output

Input numbers: 111 222

sum is: 333 EOF