125 lines
4.3 KiB
HTML
125 lines
4.3 KiB
HTML
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta name="generator" content="HTML Tidy, see www.w3.org">
|
||
|
|
<meta http-equiv="Content-Type" content=
|
||
|
|
"text/html; charset=utf-8">
|
||
|
|
<title>rexx - Run REXX procedure</title>
|
||
|
|
<LINK rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</HEAD>
|
||
|
|
<body bgcolor="#FFFFFF">
|
||
|
|
<!-- Java sync-link -->
|
||
|
|
<SCRIPT LANGUAGE="Javascript" SRC="../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h2>rexx - Run REXX procedure</h2>
|
||
|
|
|
||
|
|
<strong>Synopsis</strong>
|
||
|
|
|
||
|
|
|
||
|
|
<p>
|
||
|
|
<strong>rexx [ -c</strong> <em>cmdenv</em> <strong>] [ -t</strong> <em>type</em> <strong>]</strong> <em>path</em> <strong>[</strong> <em>arg</em> ... <strong>]</strong>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p><strong>Description</strong></p>
|
||
|
|
|
||
|
|
<p>The <strong>rexx</strong> utility runs the REXX procedure specified by <em>path</em> with the
|
||
|
|
specified <em>arguments</em>. For more information about programming with REXX, see the
|
||
|
|
<a href="../rzahg/rzahgrexx.htm">REXX information</a>.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p>The REXX interpreter cannot read REXX commands from standard input. It can only run REXX procedures
|
||
|
|
stored in members of database files in the QSYS.LIB file system. The interactive debug feature of the
|
||
|
|
REXX interpreter is not supported by the <strong>rexx</strong> utility.</p>
|
||
|
|
|
||
|
|
<p>The program /QSYS.LIB/QSHELL.LIB/QZSHSHRX.PGM implements the Qshell command environment for
|
||
|
|
REXX procedures. The Qshell command environment sets the REXX return code and condition
|
||
|
|
as follows:
|
||
|
|
<ul>
|
||
|
|
<li>When the the shell command ends normally with an
|
||
|
|
exit status of zero, the REXX return code is
|
||
|
|
set to zero and no condition is raised.</li>
|
||
|
|
<li>If the shell command ends normally with an
|
||
|
|
exit status that is non-zero, the REXX return
|
||
|
|
code is set to the exit status value and the
|
||
|
|
ERROR condition is raised.</li>
|
||
|
|
<li>If the shell command ends by signal, the REXX
|
||
|
|
return code is set to the signal number + 128
|
||
|
|
and the FAILURE condition is raised.</li>
|
||
|
|
<li>If the shell command ends by exception, the
|
||
|
|
REXX return code is set to the exception
|
||
|
|
number from wait() and the FAILURE condition
|
||
|
|
is raised.</li>
|
||
|
|
</ul>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p><strong>Options</strong></p>
|
||
|
|
|
||
|
|
<dl>
|
||
|
|
<dt><strong>-c</strong> <em>cmdenv</em></dt>
|
||
|
|
|
||
|
|
<dd>Set the command environment program to process commands for the REXX procedure.
|
||
|
|
If the option is not specified, the default value is <em>command</em>.
|
||
|
|
The <em>cmdenv</em> can be one of the following values:
|
||
|
|
<ul>
|
||
|
|
<li><em>command</em> for the i5/OS<SUP>(TM)</SUP> CL command environment.</li>
|
||
|
|
<li><em>cpicomm</em> for the Common Programming Interface for communications command environment.</li>
|
||
|
|
<li><em>execsql</em> for the Structured Query Language (SQL) command environment.</li>
|
||
|
|
<li><em>qsh</em> for the Qshell command environment.</li>
|
||
|
|
<li><em>path</em> to specify the path to the command environment program. The path must specify a
|
||
|
|
program in the QSYS.LIB file system.</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
|
||
|
|
<dt><strong>-t</strong> <em>type</em></dt>
|
||
|
|
|
||
|
|
<dd>Control tracing for the REXX procedure. If the option is not specified, the default
|
||
|
|
value is <em>normal</em>. The <em>type</em> can be one of the following values:
|
||
|
|
<ul>
|
||
|
|
<li><em>all</em> to trace all clauses before processing.</li>
|
||
|
|
<li><em>commands</em> to trace host commands before processing and display any
|
||
|
|
error return codes.</li>
|
||
|
|
<li><em>error</em> to trace host commands after processing that result in an error return code.</li>
|
||
|
|
<li><em>failure</em> to trace host commands after processing that result in a failure along with the
|
||
|
|
return code.</li>
|
||
|
|
<li><em>intermediates</em> to trace all clauses before processing along with intermediate results
|
||
|
|
during the evaluation of expressions.</li>
|
||
|
|
<li><em>labels</em> to trace labels during processing.</li>
|
||
|
|
<li><em>normal</em> to trace host commands after processing that result in a failure.</li>
|
||
|
|
<li><em>off</em> to turn off all tracing.</li>
|
||
|
|
<li><em>results</em> to trace all clauses before processing.</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
|
||
|
|
</dl>
|
||
|
|
|
||
|
|
<p><strong>Operands</strong></p>
|
||
|
|
|
||
|
|
<p>The <em>path</em> is the path name of the REXX procedure. On i5/OS<SUP>(TM)</SUP>, a REXX
|
||
|
|
procedure can only be stored in the QSYS.LIB file system.</p>
|
||
|
|
|
||
|
|
<p><strong>Exit Status</strong></p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>0 when successful</li>
|
||
|
|
|
||
|
|
<li>1 when there is an error running the REXX procedure</li>
|
||
|
|
|
||
|
|
<li>>1 when unsuccessful</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p><strong>Related information</strong></p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><a href="../rzahg/rzahgrexx.htm">REXX information</a></li>
|
||
|
|
|
||
|
|
<li><a href="system.htm">system - Run CL command</a></li>
|
||
|
|
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
</body>
|
||
|
|
</html>
|