329 lines
12 KiB
HTML
329 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 Report (PRTTRCRPT)</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="PRTTRCRPT.Top_Of_Page"></a>
|
||
|
|
<h2>Print Job Trace Report (PRTTRCRPT)</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="#PRTTRCRPT.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#PRTTRCRPT.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#PRTTRCRPT.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="PRTTRCRPT"></a>
|
||
|
|
<p>The Print Job Trace Report (PRTTRCRPT) command generates a report showing resources utilized, exceptions, and state transitions for batch jobs traced through time.
|
||
|
|
</p>
|
||
|
|
<p>The report is based on the trace data collected by the Start Performance Trace (STRPFRTRC) command. This report runs against the specified member that was created when the Print Transaction Report (PRTTNSRPT) command was run with the *FILE option. The member resides in the QTRJOBT file of the QPFRDATA library.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTRCRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="PRTTRCRPT.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="#PRTTRCRPT.MBR"><b>MBR</b></a></td>
|
||
|
|
<td valign="top">Member</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTTRCRPT.LIB"><b>LIB</b></a></td>
|
||
|
|
<td valign="top">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="#PRTTRCRPT.TITLE"><b>TITLE</b></a></td>
|
||
|
|
<td valign="top">Title</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*MBR</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="7"><a href="#PRTTRCRPT.PERIOD"><b>PERIOD</b></a></td>
|
||
|
|
<td valign="top">Time period for report</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="7">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: </td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Element list</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 1: Starting time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, <b><u>*FIRST</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 2: Starting date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Date</i>, <b><u>*FIRST</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: </td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Element list</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 1: Ending time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, <b><u>*LAST</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 2: Ending date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Date</i>, <b><u>*LAST</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTTRCRPT.JOB"><b>JOB</b></a></td>
|
||
|
|
<td valign="top">Job name</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>PRTTRCRPT</u></b>, *MBR</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#PRTTRCRPT.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="#PRTTRCRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="PRTTRCRPT.MBR"></a>
|
||
|
|
<h3>Member (MBR)</h3>
|
||
|
|
<p>Specifies the performance data member used. This name should correspond to the member name specified when the Print Transaction Report (PRTTNSRPT) command was run with *FILE option.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTRCRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTRCRPT.LIB"></a>
|
||
|
|
<h3>Library (LIB)</h3>
|
||
|
|
<p>Specifies the library where the performance data is located.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QPFRDATA</u></b></dt>
|
||
|
|
<dd>The performance data files are located in the IBM-supplied performance data library, QPFRDATA.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the performance database files are located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTRCRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTRCRPT.TITLE"></a>
|
||
|
|
<h3>Report title (TITLE)</h3>
|
||
|
|
<p>Specifies the title for the report that is created.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MBR</u></b></dt>
|
||
|
|
<dd>The text of the database member, which contains the performance data, is the report title.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'report-title'</i></b></dt>
|
||
|
|
<dd>Specify the title you want on your report with up to 50 characters of text, enclosed in apostrophes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTRCRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTRCRPT.PERIOD"></a>
|
||
|
|
<h3>Time period for report (PERIOD)</h3>
|
||
|
|
<p>Specifies the period of time on which to report. The parameter consists of two lists of two elements each.
|
||
|
|
</p>
|
||
|
|
<p>The symbol *N can be used to maintain the position in the parameter value sequence in place of an element that precedes the values that are specified. For example, PERIOD(*N (*N 091290)) specifies the ending date and uses the defaults for the other values.
|
||
|
|
</p>
|
||
|
|
<p>One of the following values is used to specify the <b>starting time</b>. Data collected prior to this time is not included in the report.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FIRST</u></b></dt>
|
||
|
|
<dd>Data records starting from the beginning of the day (00:00: 00) are included.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-time</i></b></dt>
|
||
|
|
<dd>Specify the time of the first data record to include in the report, using the format, <b>hhmm</b> or <b>hhmmss</b>, where <b>hh</b> is the hours, <b>mm</b> is the minutes, and <b>ss</b> is the seconds.
|
||
|
|
<p>The time can be specified with or without a time separator:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.
|
||
|
|
</li>
|
||
|
|
<li>With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>The time is in 24-hour format (13:00 is one p.m.); all time and date entries must be 2-digits in length, meaning zeros must be included.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>One of the following values is used to specify the <b>starting date</b>. Data collected prior to the starting time on this date is not included in the report.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FIRST</u></b></dt>
|
||
|
|
<dd>Data records starting from the first day of the collection period are included in the report.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-date</i></b></dt>
|
||
|
|
<dd>Specify the date of the first data record to include in the report. The date must be entered in the same format as specified for the job.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>One of the following values is used to specify the <b>ending time</b>. Data collected after this time on the ending date is not included in the report.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LAST</u></b></dt>
|
||
|
|
<dd>Data records through the end of the day (23:59:59) are included in the report.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>end-time</i></b></dt>
|
||
|
|
<dd>Specify the time of the last data record to include in the report. Use the same format used for the starting time.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>One of the following values is used to specify the <b>ending date</b>.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LAST</u></b></dt>
|
||
|
|
<dd>Data records through the last day of the collection period are included in the report.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>end-date</i></b></dt>
|
||
|
|
<dd>Specify the date of the last record to include in the report. The date must be entered in the same format as specified for the job.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTRCRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTRCRPT.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>PRTTRCRPT</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="#PRTTRCRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTRCRPT.JOBD"></a>
|
||
|
|
<h3>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="#PRTTRCRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="PRTTRCRPT.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Printing a Job Trace Summary Report</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
PRTTRCRPT MBR(JUNE01)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command submits a batch job that generates a Job Trace Summary report using the performance data found in the member JUNE01 of file QTRJOBT located in the default library QPFRDATA. The report covers the entire collection period, and the title of the report is set to the name of the database file member.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Specifying a Report Time Period</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
PRTTRCRPT MBR(NOV15)
|
||
|
|
PERIOD(('0800:00' '11/15/99')
|
||
|
|
('2359:59' '11/15/99'))
|
||
|
|
TITLE('Job Trace Reports for November 15')
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command submits a batch job that generates a Job Trace Summary report. The performance data comes from member NOV15 of file QTRJOBT of the default library QPFRDATA. The report covers the time period 8:00 in the morning to midnight of one day.
|
||
|
|
</p>
|
||
|
|
<p><b>Note:</b> The format for the date and time is determined by the system values QDATFMT and, because separators are used in this example, QDATSEP.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTRCRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="PRTTRCRPT.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>PFR5515</b></dt>
|
||
|
|
<dd>Cannot access trace data.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTRCRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|