136 lines
4.4 KiB
HTML
136 lines
4.4 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>Display Trace (DSPTRC)</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="DSPTRC.Top_Of_Page"></a>
|
|
<h2>Display Trace (DSPTRC)</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="#DSPTRC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSPTRC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSPTRC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSPTRC"></a>
|
|
<p>The Display Trace (DSPTRC) command shows all of the traces that are currently defined in the programs specified in this command. The following trace information is shown:
|
|
</p>
|
|
<ul>
|
|
<li>The statement ranges or machine instruction ranges in the program
|
|
</li>
|
|
<li>The name or MI ODV numbers of all the program variables associated with the trace statements
|
|
</li>
|
|
<li>If the variables are recorded whenever the trace statement is processed or only when their values are changed
|
|
</li>
|
|
</ul>
|
|
<p><b>Restriction:</b> This command is valid only in debug mode.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSPTRC.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="#DSPTRC.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*</u></b>, *PRINT</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPTRC.PGM"><b>PGM</b></a></td>
|
|
<td valign="top">Program</td>
|
|
<td valign="top">Single values: <b><u>*DFTPGM</u></b>, *ALL<br>Other values (up to 20 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSPTRC.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>The output is printed with the job's spooled output.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPTRC.PGM"></a>
|
|
<h3>Program (PGM)</h3>
|
|
<p>Specifies which programs in debug mode have their trace statements and associated program variables shown.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DFTPGM</u></b></dt>
|
|
<dd>Only the default program has its trace statements shown.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All the programs currently in debug mode have their trace statements shown.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the names of up to 20 programs to have their trace statements shown. The programs specified must already be in debug mode.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPTRC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
DSPTRC
|
|
</pre>
|
|
</p>
|
|
<p>This command shows all of the trace data statement ranges currently specified in the default program of this debugging session. Also displayed are the program variables (but not their values) that are associated with the trace data statements.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPTRC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1999</b></dt>
|
|
<dd>Errors occurred on command.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|