170 lines
6.2 KiB
HTML
170 lines
6.2 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>Start Job Trace (STRJOBTRC)</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="STRJOBTRC.Top_Of_Page"></a>
|
|
<h2>Start Job Trace (STRJOBTRC)</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="#STRJOBTRC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRJOBTRC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRJOBTRC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRJOBTRC"></a>
|
|
<p>The Start Job Trace (STRJOBTRC) command starts the job tracing function to collect performance statistics for the specified job. It issues the following command:
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRTRC MAXSTG(maxstg) TRCFULL(*STOPTRC)
|
|
</pre>
|
|
</p>
|
|
<p>The MAXSTG value used is either the STRJOBTRC default or a specified value.
|
|
</p>
|
|
<p>Once job tracing is started, a trace record is generated for every external (program) call and return, exception, message, and work station wait in the job. At least two, and usually more, trace records are generated for every I/O statement (open, close, read, write) in a high-level language program.
|
|
</p>
|
|
<p>After the target programs have been run, the End Job Trace (ENDJOBTRC) command is used to turn tracing off, record the collected information in a database file, and optionally produce reports used to analyze the data. The Print Job Trace (PRTJOBTRC) command may also be used to print the same report at any time thereafter. Alternatively, specifying *DLT on the <b>Data option</b> prompt (DTAOPT parameter) of the End Trace (ENDTRC) command may be used to stop the job trace (turn it off without recording any collected data).
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJOBTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRJOBTRC.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="#STRJOBTRC.MAXSTG"><b>MAXSTG</b></a></td>
|
|
<td valign="top">Maximum storage</td>
|
|
<td valign="top">1-4000000, <b><u>10000</u></b></td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#STRJOBTRC.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top">Single values: <b><u>*</u></b><br>Other values: <i>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Job name</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: User</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000000-999999</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#STRJOBTRC.THDID"><b>THDID</b></a></td>
|
|
<td valign="top">Thread ID to include</td>
|
|
<td valign="top">Values (up to 20 repetitions): <i>Hexadecimal value</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJOBTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRJOBTRC.MAXSTG"></a>
|
|
<h3>Maximum storage (MAXSTG)</h3>
|
|
<p>Specifies the maximum amount of storage to allocate to the internal buffer in which every trace record generated is stored. If enough trace records are collected to fill the buffer, tracing is automatically turned off.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>10000</u></b></dt>
|
|
<dd>A 10000K trace buffer is used.
|
|
</dd>
|
|
<dt><b><i>maximum-K-bytes</i></b></dt>
|
|
<dd>Specify the size of the trace buffer in kilobytes (one kilobyte equals 1024 bytes).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJOBTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRJOBTRC.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the job to be traced. A job identifier is either the special value, *, or the job-identifier name and library with up to three elements, such as job-number/user-name/ job-name.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The current job is traced.
|
|
</dd>
|
|
<dt><b><i>job-name</i></b></dt>
|
|
<dd>Specify the name of the job to be traced.
|
|
</dd>
|
|
<dt><b><i>user-name</i></b></dt>
|
|
<dd>Specify the user name of the job to be traced.
|
|
</dd>
|
|
<dt><b><i>job-number</i></b></dt>
|
|
<dd>Specify the 6-digit number of the job to be traced. All 6 digits must be specified, including zeros.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJOBTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRJOBTRC.THDID"></a>
|
|
<h3>Thread ID to include (THDID)</h3>
|
|
<p>Specifies a list of up to twenty threads whose calls and returns are included in the trace. Only trace records for the specified thread identifiers are included.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The calls and returns for all threads are included in the trace.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>hexadecimal-value</i></b></dt>
|
|
<dd>Specify the identifiers of up to twenty threads whose trace records are to be included.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJOBTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRJOBTRC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
STRJOBTRC MAXSTG(512)
|
|
</pre>
|
|
</p>
|
|
<p>This command starts collecting trace data for the current job. It uses a 512 kilobyte (KB) trace buffer.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJOBTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRJOBTRC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p>None
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRJOBTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|