128 lines
4.8 KiB
HTML
128 lines
4.8 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Trace REXX (TRCREX)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="TRCREX.Top_Of_Page"></a>
|
|
<h2>Trace REXX (TRCREX)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#TRCREX.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#TRCREX.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#TRCREX.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="TRCREX"></a>
|
|
<p>The Trace REXX (TRCREX) command is used to turn the interpreter function on or off from command entry or from control language (CL) programming level.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCREX.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="TRCREX.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#TRCREX.SET"><b>SET</b></a></td>
|
|
<td valign="top">Trace option setting</td>
|
|
<td valign="top"><b><u>*RESULTS</u></b>, *ALL, *COMMANDS, *ERROR, *FAILURE, *INTERMEDIATES, *LABELS, *NORMAL, *OFF</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCREX.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="TRCREX.SET"></a>
|
|
<h3>Trace option setting (SET)</h3>
|
|
<p>Specifies the initial trace setting for the next REXX procedure that is run. This setting remains in effect unless changed through the REXX TRACE instruction.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*RESULTS</u></b></dt>
|
|
<dd>All clauses are traced before processing. Tracing operates as if the TRACE ?R instruction was used from within the REXX procedure.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All clauses are traced before processing. Tracing operates as if the TRACE ?A instruction was used from within the REXX procedure.
|
|
</dd>
|
|
<dt><b>*COMMANDS</b></dt>
|
|
<dd>All host commands are traced before processing and any error return code is displayed. Tracing operates as if the TRACE ?C instruction was used from within the REXX procedure.
|
|
</dd>
|
|
<dt><b>*ERROR</b></dt>
|
|
<dd>Any host command resulting in an error return code is traced after processing. Tracing operates as if the TRACE ?E instruction was used from within the REXX procedure.
|
|
</dd>
|
|
<dt><b>*FAILURE</b></dt>
|
|
<dd>Any host command resulting in a failure is traced after processing together with the return code from the command. Tracing operates as if the TRACE ?F instruction was used from within the REXX procedure.
|
|
</dd>
|
|
<dt><b>*INTERMEDIATES</b></dt>
|
|
<dd>All clauses are traced before processing. Intermediate results during evaluation of expressions and substituted names are also traced. Tracing operates as if the TRACE ?I instruction was used from within the REXX procedure.
|
|
</dd>
|
|
<dt><b>*LABELS</b></dt>
|
|
<dd>Labels passed during processing are traced. Tracing operates as if the TRACE ?L instruction was used from within the REXX procedure.
|
|
</dd>
|
|
<dt><b>*NORMAL</b></dt>
|
|
<dd>Any failing host command is traced after processing. Tracing operates as if the TRACE ?N instruction was used from within the REXX procedure. This is the default setting.
|
|
</dd>
|
|
<dt><b>*OFF</b></dt>
|
|
<dd>Nothing is traced. Tracing operates as if the TRACE O instruction was used from within the REXX procedure.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCREX.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="TRCREX.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Tracing Host Commands</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
TRCREX SET(*COMMANDS)
|
|
</pre>
|
|
</p>
|
|
<p>This command causes all commands in by the REXX procedure to be shown before they are to be run.
|
|
</p>
|
|
<p><b>Example 2: Tracing Failing Host Commands</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
TRCREX SET(*NORMAL)
|
|
</pre>
|
|
</p>
|
|
<p>This command causes all commands that result in a FAILURE condition to be shown. This command shows the normal setting for the REXX tracing operation.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCREX.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="TRCREX.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p>None
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCREX.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|