343 lines
13 KiB
HTML
343 lines
13 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>End Job Trace (ENDJOBTRC)</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="ENDJOBTRC.Top_Of_Page"></a>
|
||
|
|
<h2>End Job Trace (ENDJOBTRC)</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="#ENDJOBTRC.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#ENDJOBTRC.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#ENDJOBTRC.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="ENDJOBTRC"></a>
|
||
|
|
<p>The End Job Trace (ENDJOBTRC) command turns off the job tracing function that was started by the Start Job Trace (STRJOBTRC) command, saves all collected trace records in a database file, and optionally produces reports that are used to analyze the data for information about performance. The Print Job Trace (PRTJOBTRC) command may also be used to produce reports from the same source data.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ENDJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="ENDJOBTRC.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="#ENDJOBTRC.MBR"><b>MBR</b></a></td>
|
||
|
|
<td valign="top">Output 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="#ENDJOBTRC.LIB"><b>LIB</b></a></td>
|
||
|
|
<td valign="top">Output 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="#ENDJOBTRC.RPTTYPE"><b>RPTTYPE</b></a></td>
|
||
|
|
<td valign="top">Report type</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *DETAIL, *SUMMARY, *BOTH</td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ENDJOBTRC.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="#ENDJOBTRC.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="#ENDJOBTRC.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="#ENDJOBTRC.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="#ENDJOBTRC.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="#ENDJOBTRC.JOB"><b>JOB</b></a></td>
|
||
|
|
<td valign="top">Job name</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>ENDJOBTRC</u></b>, *MBR</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#ENDJOBTRC.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="#ENDJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="ENDJOBTRC.MBR"></a>
|
||
|
|
<h3>Output file member (MBR)</h3>
|
||
|
|
<p>Specifies the member in file QAPTTRCJ in which to save the trace data. If the member does not exist, it is added to the file. If the member exists, the new data replaces the old contents.
|
||
|
|
</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 an alternate member in which to save the data. This allows several sets of job trace data to be kept.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ENDJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ENDJOBTRC.LIB"></a>
|
||
|
|
<h3>Output file library (LIB)</h3>
|
||
|
|
<p>Specifies the library where the trace data is saved. If the library does not contain a file named QAPTTRCJ, one is created.
|
||
|
|
</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 an alternate library where the trace data is saved. This is necessary if access to the default library is not allowed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ENDJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ENDJOBTRC.RPTTYPE"></a>
|
||
|
|
<h3>Report type (RPTTYPE)</h3>
|
||
|
|
<p>Specifies the type of reports being produced.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No reports are produced; however, the Print Job Trace (PRTJOBTRC) command may be used later to report on the saved data. None of the remaining parameters are applicable if this value is selected.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DETAIL</b></dt>
|
||
|
|
<dd>A report is produced that shows the individual job trace records in detail. 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 work station 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>
|
||
|
|
<dt><b>*BOTH</b></dt>
|
||
|
|
<dd>Both the detail report and the two summary reports are produced (three reports total).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ENDJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ENDJOBTRC.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="#ENDJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ENDJOBTRC.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 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 is determined by previewing reports that are produced from 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="#ENDJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ENDJOBTRC.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="#ENDJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ENDJOBTRC.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 display 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-display station transactions, such as communications lines.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ENDJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ENDJOBTRC.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 display 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="#ENDJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ENDJOBTRC.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>ENDJOBTRC</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="#ENDJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ENDJOBTRC.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="#ENDJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ENDJOBTRC.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Stopping Job Tracing</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ENDJOBTRC
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command stops tracing and saves the created trace records in QPFRDATA/QAPTTRCJ, member QAJOBTRC. No reports are produced.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Producing a Report of Job Records</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ENDJOBTRC LIB(MYLIB) RPTTYPE(*DETAIL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command stops job tracing, saves the created trace records in member QAJOBTRC of MYLIB/QAPTTRCJ, and produces a detail report. The use of a private library allows several users to trace jobs at the same time.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ENDJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ENDJOBTRC.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p>None
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ENDJOBTRC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|