332 lines
12 KiB
HTML
332 lines
12 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>Print Job Trace (PRTJOBTRC)</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="PRTJOBTRC.Top_Of_Page"></a>
|
||
|
|
<h2>Print Job Trace (PRTJOBTRC)</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="#PRTJOBTRC.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#PRTJOBTRC.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#PRTJOBTRC.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="PRTJOBTRC"></a>
|
||
|
|
<p>The Print Job Trace (PRTJOBTRC) command produces performance-oriented reports that are used to analyze job trace data collected earlier with the Start Job Trace (STRJOBTRC) and End Job Trace (ENDJOBTRC) commands.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="PRTJOBTRC.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="#PRTJOBTRC.MBR"><b>MBR</b></a></td>
|
||
|
|
<td valign="top">Data base file member</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>QAJOBTRC</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTJOBTRC.LIB"><b>LIB</b></a></td>
|
||
|
|
<td valign="top">Data base file library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>QPFRDATA</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTJOBTRC.RPTTYPE"><b>RPTTYPE</b></a></td>
|
||
|
|
<td valign="top">Report type</td>
|
||
|
|
<td valign="top"><b><u>*BOTH</u></b>, *DETAIL, *SUMMARY</td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTJOBTRC.TITLE"><b>TITLE</b></a></td>
|
||
|
|
<td valign="top">Report title</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 4</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTJOBTRC.STRSEQ"><b>STRSEQ</b></a></td>
|
||
|
|
<td valign="top">Starting sequence number</td>
|
||
|
|
<td valign="top">1-999999, <b><u>*FIRST</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTJOBTRC.ENDSEQ"><b>ENDSEQ</b></a></td>
|
||
|
|
<td valign="top">Ending sequence number</td>
|
||
|
|
<td valign="top"><i>Decimal number</i>, <b><u>*LAST</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTJOBTRC.ENDTNS"><b>ENDTNS</b></a></td>
|
||
|
|
<td valign="top">Transaction ending program</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>QT3REQIO</u></b>, *BATCH</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTJOBTRC.STRTNS"><b>STRTNS</b></a></td>
|
||
|
|
<td valign="top">Transaction starting program</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>QWSGET</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTJOBTRC.JOB"><b>JOB</b></a></td>
|
||
|
|
<td valign="top">Job name</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>PRTJOBTRC</u></b>, *MBR</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#PRTJOBTRC.JOBD"><b>JOBD</b></a></td>
|
||
|
|
<td valign="top">Job description</td>
|
||
|
|
<td valign="top">Single values: *NONE<br>Other values: <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Job description</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>QPFRJOBD</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
|
</tr></table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="PRTJOBTRC.MBR"></a>
|
||
|
|
<h3>Data base file member (MBR)</h3>
|
||
|
|
<p>Specifies the member in file QAPTTRCJ in which the trace data is saved by the End Job Trace (ENDJOBTRC) command.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QAJOBTRC</u></b></dt>
|
||
|
|
<dd>The standard member name, QAJOBTRC, is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>member-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the member in which the data is saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTJOBTRC.LIB"></a>
|
||
|
|
<h3>Data base file library (LIB)</h3>
|
||
|
|
<p>Specifies the library in which the job trace data is saved by the End Job Trace (ENDJOBTRC) command.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QPFRDATA</u></b></dt>
|
||
|
|
<dd>The trace data is saved in the IBM-supplied performance data library, QPFRDATA.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library in which the trace data is saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTJOBTRC.RPTTYPE"></a>
|
||
|
|
<h3>Report type (RPTTYPE)</h3>
|
||
|
|
<p>Specifies the type of report(s) to produce.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If summary reports are selected (by specifying *BOTH or *SUMMARY for this parameter), the summary reports contain information only when transaction ending program and transaction starting program pairs are found in the collected data.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BOTH</u></b></dt>
|
||
|
|
<dd>Both the detail and summary reports are produced (three reports total).
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DETAIL</b></dt>
|
||
|
|
<dd>A report is produced detailing the individual job trace records. The output is directed to the printer file QPPTTRCD. Each page heading includes the text 'Job Trace Information'.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SUMMARY</b></dt>
|
||
|
|
<dd>Two reports are produced summarizing the job trace data by transaction. One report shows primarily physical disk activity; its printer file is QPPTTRC1, and its page heading includes the text 'Trace Analysis Summary'. The other report concentrates on higher level activities such as database I/O and inter-program transfers of control; its printer file is QPPTTRC2, and its page heading includes the text 'Trace Analysis I/O Summary'.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTJOBTRC.TITLE"></a>
|
||
|
|
<h3>Report title (TITLE)</h3>
|
||
|
|
<p>Specifies a title that is printed on the page heading of each report.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BLANK</u></b></dt>
|
||
|
|
<dd>No title is specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'report-title'</i></b></dt>
|
||
|
|
<dd>Specify title of up to 50 characters enclosed in apostrophes. This may be used, for example, to distinguish between reports on different sets of trace data or different sections of the same data.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTJOBTRC.STRSEQ"></a>
|
||
|
|
<h3>Starting sequence number (STRSEQ)</h3>
|
||
|
|
<p>Specifies the sequence number of the first job trace record that is included in any reports. No records preceding this one are listed in the detail report or counted in either summary report.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FIRST</u></b></dt>
|
||
|
|
<dd>Trace records starting from the first job trace record (sequence number 1) are included.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>sequence-number</i></b></dt>
|
||
|
|
<dd>Specify the sequence of the first trace record that is included. An appropriate value can be determined by previewing reports produced from all the job trace data. This can be used to bracket a particular set of transactions on which to report.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTJOBTRC.ENDSEQ"></a>
|
||
|
|
<h3>Ending sequence number (ENDSEQ)</h3>
|
||
|
|
<p>Specifies the sequence number of the last job trace record that is included in any reports. No records following this one are listed in the detail report or counted in either summary report.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LAST</u></b></dt>
|
||
|
|
<dd>Trace records through the last trace record are included.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>sequence-number</i></b></dt>
|
||
|
|
<dd>Specify the sequence number of the last trace record that is included. An appropriate value can be chosen through a preview process so as to bracket a particular set of transactions.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTJOBTRC.ENDTNS"></a>
|
||
|
|
<h3>Transaction ending program (ENDTNS)</h3>
|
||
|
|
<p>Specifies the program that signifies the end of a transaction. A program must also be specified on the <b>Transaction starting program</b> prompt (STRTNS parameter).
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QT3REQIO</u></b></dt>
|
||
|
|
<dd>The work station I/O program, QT3REQIO, is used. This value is used to break the trace data into work station transactions.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>program-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the program that ends a transaction. This allows reporting on non-work station transactions, such as communications lines.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTJOBTRC.STRTNS"></a>
|
||
|
|
<h3>Transaction starting program (STRTNS)</h3>
|
||
|
|
<p>Specifies the program that signifies the start of a transaction. A program must also be specified on the <b>Transaction ending program</b> prompt (ENDTNS parameter).
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QWSGET</u></b></dt>
|
||
|
|
<dd>The work station input program, QWSGET, is used. This value is used to break the trace data into work station transactions.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>program-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the program that starts a transaction.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTJOBTRC.JOB"></a>
|
||
|
|
<h3>Job name (JOB)</h3>
|
||
|
|
<p>Specifies the job name to be used if submitting the job for batch processing.
|
||
|
|
</p>
|
||
|
|
<p>Any value for this parameter is ignored if *NONE is specified for the <b>Job description</b> prompt (JOBD parameter).
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *NONE is specified for the <b>Job description</b> prompt (JOBD parameter), job processing is performed interactively.
|
||
|
|
</p>
|
||
|
|
<p>The possible <b>job-name</b> values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>PRTJOBTRC</u></b></dt>
|
||
|
|
<dd>The command name is used for the job name.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MBR</b></dt>
|
||
|
|
<dd>The name selected for the performance data member in the <b>Member</b> prompt (MBR parameter) is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>job-name</i></b></dt>
|
||
|
|
<dd>Specify the name to be used for any and all batch jobs.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTJOBTRC.JOBD"></a>
|
||
|
|
<h3>Batch job description (JOBD)</h3>
|
||
|
|
<p>Specifies the job description used to submit the job for batch processing.
|
||
|
|
</p>
|
||
|
|
<p>The possible job description values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QPFRJOBD</u></b></dt>
|
||
|
|
<dd>The IBM-supplied job description, QPFRJOBD, is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>job-description-name</i></b></dt>
|
||
|
|
<dd>Specify the name of an alternate job description.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>A batch job is not submitted; processing continues interactively while the user waits. The user's workstation is not available for other use during this time, which could be significant for long jobs.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the job's library list are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the job is used to locate the job description. If no current library entry exists in the library list, QGPL is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the library in which the job description is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="PRTJOBTRC.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
PRTJOBTRC LIB(MYLIB) RPTTYPE(*DETAIL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command produces a detail report using data saved in member QAJOBTRC of file QAPTTRCJ in library MYLIB.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="PRTJOBTRC.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p>None
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|