269 lines
8.3 KiB
HTML
269 lines
8.3 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 Performance Trace (STRPFRTRC)</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="STRPFRTRC.Top_Of_Page"></a>
|
|
<h2>Start Performance Trace (STRPFRTRC)</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="#STRPFRTRC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRPFRTRC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRPFRTRC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRPFRTRC"></a>
|
|
<p>The Start Performance Trace (STRPFRTRC) command is a simplified interface to the TRCINT command for collecting Multiprogramming level (MPL) and Transaction trace data. This command collects the same performance trace data as was collected in previous releases by the Start Performance Monitor (STRPFRMON) command.
|
|
</p>
|
|
<p>The trace started by this command creates and uses trace table QPM_STRPFRTRC.If the trace table exists, any existing data will be deleted before this trace begins.
|
|
</p>
|
|
<p>The trace can be stopped and the data can be written to a data base file by using the End Performance Trace (ENDPFRTRC) command.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>This command is shipped with public *EXCLUDE authority.
|
|
</li>
|
|
<li>The following user profiles have private authorities to use the command:
|
|
<ul>
|
|
<li>QSRV
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRPFRTRC.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" rowspan="3"><a href="#STRPFRTRC.SIZE"><b>SIZE</b></a></td>
|
|
<td valign="top">Trace table size</td>
|
|
<td valign="top">Single values: <b><u>*CALC</u></b>, *MAX<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Number of units</td>
|
|
<td valign="top">
|
|
1-998000</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Unit of measure</td>
|
|
<td valign="top">
|
|
<b><u>*KB</u></b>, *MB</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPFRTRC.OMTTRCPNT"><b>OMTTRCPNT</b></a></td>
|
|
<td valign="top">Omit trace points</td>
|
|
<td valign="top"><b><u>*NONE</u></b>, *RSCMGT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPFRTRC.JOBTYPE"><b>JOBTYPE</b></a></td>
|
|
<td valign="top">Job types</td>
|
|
<td valign="top">Single values: *NONE, *ALL<br>Other values (up to 12 repetitions): <b><u>*DFT</u></b>, *ASJ, *BCH, *EVK, *INT, *MRT, *RDR, *SBS, *SYS, *WTR, *PDJ, *PJ, *BCI</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRPFRTRC.JOBTRCITV"><b>JOBTRCITV</b></a></td>
|
|
<td valign="top">Job trace interval</td>
|
|
<td valign="top">0.1-9.9, <b><u>0.5</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRPFRTRC.SIZE"></a>
|
|
<h3>Trace table size (SIZE)</h3>
|
|
<p>Specifies the size of the trace table.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The storage indicated on this parameter is immediately allocated from the system auxiliary storage pool (ASP 1). Refer to the Trace Internal (TRCINT) command SIZE parameter for additional information regarding the setting of trace table size.
|
|
</p>
|
|
<p>Specifying a size of less than 16 megabytes is not recommended.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CALC</u></b></dt>
|
|
<dd>The minimum trace table size is determined based on the processor group of your system.
|
|
</dd>
|
|
<dt><b>*MAX</b></dt>
|
|
<dd>The trace table is set to the maximum size of 258048 megabytes.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Number of units</b>
|
|
</p>
|
|
<p>Specify the size of the trace table.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>1-998000</i></b></dt>
|
|
<dd>Specify the size of the trace table in kilobytes or megabytes.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Unit of measure</b>
|
|
</p>
|
|
<p>Specify whether the value specified for the first element of this parameter should be treated as number of kilobytes or number of megabytes.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*KB</u></b></dt>
|
|
<dd>The trace table size is specified in kilobytes. The valid range is 128 through 998000.
|
|
</dd>
|
|
<dt><b>*MB</b></dt>
|
|
<dd>The trace table size is specified in megabytes. The valid range is 1 through 258048.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPFRTRC.OMTTRCPNT"></a>
|
|
<h3>Omit trace points (OMTTRCPNT)</h3>
|
|
<p>Specifies trace points whose trace records are to be excluded.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No trace points are to be excluded.
|
|
</dd>
|
|
<dt><b>*RSCMGT</b></dt>
|
|
<dd>Resource management trace points (seize/lock conflict data) will be excluded from the trace.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPFRTRC.JOBTYPE"></a>
|
|
<h3>Job types (JOBTYPE)</h3>
|
|
<p>Specifies the types of jobs for which trace data is to be collected for use in the batch job trace report.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The value *DFT includes the values *ASJ, *BCH, *EVK, *MRT, *PDJ, *PJ and *BCI. The value *BCH includes the values *EVK, *MRT, *PDJ, *PJ, and *BCI.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No jobs are to be traced.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All job types are to be traced.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 12 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DFT</u></b></dt>
|
|
<dd>Batch and autostart jobs are traced.
|
|
</dd>
|
|
<dt><b>*ASJ</b></dt>
|
|
<dd>Autostart jobs are traced.
|
|
</dd>
|
|
<dt><b>*BCH</b></dt>
|
|
<dd>Batch jobs are traced.
|
|
</dd>
|
|
<dt><b>*EVK</b></dt>
|
|
<dd>Jobs started by a procedure start request are traced.
|
|
</dd>
|
|
<dt><b>*INT</b></dt>
|
|
<dd>Interactive jobs are traced.
|
|
</dd>
|
|
<dt><b>*MRT</b></dt>
|
|
<dd>Multiple requester terminal jobs are traced.
|
|
</dd>
|
|
<dt><b>*RDR</b></dt>
|
|
<dd>Reader jobs are traced.
|
|
</dd>
|
|
<dt><b>*SBS</b></dt>
|
|
<dd>Subsystem monitor jobs are traced.
|
|
</dd>
|
|
<dt><b>*SYS</b></dt>
|
|
<dd>System jobs are traced.
|
|
</dd>
|
|
<dt><b>*WRT</b></dt>
|
|
<dd>Writer jobs are traced.
|
|
</dd>
|
|
<dt><b>*PDJ</b></dt>
|
|
<dd>Print driver jobs are traced.
|
|
</dd>
|
|
<dt><b>*PJ</b></dt>
|
|
<dd>Prestart jobs are traced.
|
|
</dd>
|
|
<dt><b>*BCI</b></dt>
|
|
<dd>Batch immediate jobs are traced.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRPFRTRC.JOBTRCITV"></a>
|
|
<h3>Job trace interval (JOBTRCITV)</h3>
|
|
<p>Specifies the time interval (in CPU seconds) to be used between each collection of the job trace data.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>0.5</u></b></dt>
|
|
<dd>A time slice interval value of 0.5 CPU seconds is used.
|
|
</dd>
|
|
<dt><b><i>0.1-9.9</i></b></dt>
|
|
<dd>Specify the trace interval to be used, in CPU seconds.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRPFRTRC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
STRPFRTRC SIZE(*CALC)
|
|
</pre>
|
|
</p>
|
|
<p>This command starts the collection of performance trace data. The trace table size may be adjusted to the calculated minimum. This example will result in the same trace table size and data as would STRPFRMON TRACE(*ALL) DMPTRC(*NO).
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRPFRTRC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF0A2A</b></dt>
|
|
<dd>Performance trace already started
|
|
</dd>
|
|
</dl>
|
|
<p>Also refer to the TRCINT command for other messages.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRPFRTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|