665 lines
26 KiB
HTML
665 lines
26 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 Transaction Report (PRTTNSRPT)</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="PRTTNSRPT.Top_Of_Page"></a>
|
||
|
|
<h2>Print Transaction Report (PRTTNSRPT)</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="#PRTTNSRPT.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#PRTTNSRPT.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#PRTTNSRPT.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="PRTTNSRPT"></a>
|
||
|
|
<p>The Print Transaction Report (PRTTNSRPT) command creates and prints performance reports that show detailed information about the transactions that occurred during the time that the performance data was collected. These reports require that trace data be collected by using the Start Performance Trace (STRPFRTRC) command. Jobs may be selectively included or excluded from the reports, based on a variety of job details and interval times.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="PRTTNSRPT.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="#PRTTNSRPT.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="#PRTTNSRPT.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 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTTNSRPT.RPTTYPE"><b>RPTTYPE</b></a></td>
|
||
|
|
<td valign="top">Report type</td>
|
||
|
|
<td valign="top">Values (up to 5 repetitions): <b><u>*SUMMARY</u></b>, *TNSACT, *TRSIT, *FILE, *TRCDTA</td>
|
||
|
|
<td valign="top">Optional, Positional 4</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="5"><a href="#PRTTNSRPT.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="5">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">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"><a href="#PRTTNSRPT.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="#PRTTNSRPT.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Report option</td>
|
||
|
|
<td valign="top">Values (up to 7 repetitions): <b><u>*SS</u></b>, *SI, *OZ, *EV, *HV, *DI, *DQ, X'40'</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTTNSRPT.DETAIL"><b>DETAIL</b></a></td>
|
||
|
|
<td valign="top">Report detail</td>
|
||
|
|
<td valign="top"><b><u>*JOB</u></b>, *THREAD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#PRTTNSRPT.SLTJOB"><b>SLTJOB</b></a></td>
|
||
|
|
<td valign="top">Select jobs</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Job name</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i></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: Thread</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#PRTTNSRPT.OMTJOB"><b>OMTJOB</b></a></td>
|
||
|
|
<td valign="top">Omit jobs</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Job name</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i></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: Thread</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTTNSRPT.SLTUSRID"><b>SLTUSRID</b></a></td>
|
||
|
|
<td valign="top">Select users</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Generic name, name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTTNSRPT.OMTUSRID"><b>OMTUSRID</b></a></td>
|
||
|
|
<td valign="top">Omit users</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Generic name, name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTTNSRPT.SLTPOOLS"><b>SLTPOOLS</b></a></td>
|
||
|
|
<td valign="top">Select pools</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 64 repetitions): 1-64, 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 1, 2, 3, 4, 5, 6, 7, 8, 9</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTTNSRPT.OMTPOOLS"><b>OMTPOOLS</b></a></td>
|
||
|
|
<td valign="top">Omit pools</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 64 repetitions): 1-64, 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 1, 2, 3, 4, 5, 6, 7, 8, 9</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTTNSRPT.SLTFCNARA"><b>SLTFCNARA</b></a></td>
|
||
|
|
<td valign="top">Select functional areas</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTTNSRPT.OMTFCNARA"><b>OMTFCNARA</b></a></td>
|
||
|
|
<td valign="top">Omit functional areas</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#PRTTNSRPT.JOB"><b>JOB</b></a></td>
|
||
|
|
<td valign="top">Job name</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>PRTTNSRPT</u></b>, *MBR</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#PRTTNSRPT.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="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="PRTTNSRPT.MBR"></a>
|
||
|
|
<h3>Member (MBR)</h3>
|
||
|
|
<p>Specifies the performance data member used. This name should correspond to the member name specified on the MBR parameter of the End Performance Trace (ENDPFRTRC) command.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.TITLE"></a>
|
||
|
|
<h3>Report title (TITLE)</h3>
|
||
|
|
<p>Specifies the title for the transaction report that is created.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BLANK</u></b></dt>
|
||
|
|
<dd>No title is placed on the transaction report.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'report-title'</i></b></dt>
|
||
|
|
<dd>Specify the title you want on your transaction report. Specify up to 50 characters enclosed in apostrophes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.RPTTYPE"></a>
|
||
|
|
<h3>Report type (RPTTYPE)</h3>
|
||
|
|
<p>Specifies the type of transaction analysis report that is printed. A list of report types can be requested, so that both summary level and transaction detail reports can be requested at the same time. The transaction detail and transition detail reports are quite detailed, and should only be combined with a selection of specific jobs, users, and/or time intervals.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SUMMARY</u></b></dt>
|
||
|
|
<dd>A summary level report is printed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*TNSACT</b></dt>
|
||
|
|
<dd>The transaction detail report is printed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*TRSIT</b></dt>
|
||
|
|
<dd>The transition detail report is printed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FILE</b></dt>
|
||
|
|
<dd>Transaction summary, job summary, and job trace database file members are created. The summaries exist in the files QTRTSUM, QTRJSUM, and QTRJOBT in the library specified for the <b>Library</b> prompt (LIB parameter). The member names are specified on the <b>Member</b> prompt (MBR parameter). The data in an existing member is replaced as a result of running this command. This value is used to build field level database files that are processed by user-defined programs and the Print Job Trace Report (PRTTRCRPT) command.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*TRCDTA</b></dt>
|
||
|
|
<dd>A database file version of the trace data file QAPMDMPT is created. The database file is named QTRDMPT and is a field-level database file which can be processed by user-defined programs.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.PERIOD"></a>
|
||
|
|
<h3>Time period for report (PERIOD)</h3>
|
||
|
|
<p>Specifies the times when transactions are reported.
|
||
|
|
</p>
|
||
|
|
<p><b>Starting Time</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FIRST</u></b></dt>
|
||
|
|
<dd>Transactions are reported beginning with the first one recorded.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-time</i></b></dt>
|
||
|
|
<dd>Specify the time of the first transaction to include in the report. The time is specified as 4 or 6 digits (hhmm or hhmmss), where <b>hh</b> is the hour, <b>mm</b> is the minute, and <b>ss</b> is the second.
|
||
|
|
<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>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Ending Time</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LAST</u></b></dt>
|
||
|
|
<dd>Transactions are reported ending with the last one recorded.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>end-time</i></b></dt>
|
||
|
|
<dd>Specify the time of the last transaction to include in the report. The time is specified as 4 or 6 digits (hhmm or hhmmss), where hh is the hour, mm is the minute, and ss is the second.
|
||
|
|
<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>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.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="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.OPTION"></a>
|
||
|
|
<h3>Report option (OPTION)</h3>
|
||
|
|
<p>Specifies additional options that you apply to the transaction report.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SS</u></b></dt>
|
||
|
|
<dd>An additional set of system summary reports are included. These reports are included if *SUMMARY is specified on the <b>Report type</b> prompt (RPTTYPE parameter).
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SI</b></dt>
|
||
|
|
<dd>All jobs of type interactive are selected.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OZ</b></dt>
|
||
|
|
<dd>All jobs that have zero transactions are omitted from the *SUMMARY report.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*EV</b></dt>
|
||
|
|
<dd>Event wait is considered as a transaction boundary. This is useful in the analysis of communications jobs.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*HV</b></dt>
|
||
|
|
<dd>System Licensed Internal Code (SLIC) tasks are listed on the *SUMMARY report.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DI</b></dt>
|
||
|
|
<dd>The trace records for the display I/O transaction boundary are counted as transactions, instead of wait-to-active state transitions.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DQ</b></dt>
|
||
|
|
<dd>The trace records for the data queue transaction boundary are counted as transactions, instead of wait-to-active state transitions.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.DETAIL"></a>
|
||
|
|
<h3>Report detail (DETAIL)</h3>
|
||
|
|
<p>Specifies whether you want the report to provide detailed job information at the job level or the thread level.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOB</u></b></dt>
|
||
|
|
<dd>Specifies that you want detailed information at the job level.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*THREAD</b></dt>
|
||
|
|
<dd>Specifies that you want detailed information at the thread level.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.SLTJOB"></a>
|
||
|
|
<h3>Select jobs (SLTJOB)</h3>
|
||
|
|
<p>Specifies which jobs are included in the report. This allows the user to narrow the scope of the report to certain jobs through job selection.
|
||
|
|
</p>
|
||
|
|
<p>The <b>Select jobs</b> prompt (SLTJOB parameter) and <b>Omit jobs</b> prompt (OMTJOB parameter) are mutually exclusive, so the default must be used for at least one of them.
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Job name</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All jobs are included in the report.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>job-name</i></b></dt>
|
||
|
|
<dd>Specify the jobs that are included in the report. A generic job name may be specified in the form, NAME*.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The job name is not a fully qualified job name. It is the ten-character job name portion of the qualified name. The job number is allowed on this parameter. You cannot mix the use of job name and job number, one or the other must be used on a given request.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Thread</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All threads are included, unless excluded by some other selection criterion.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>thread-identifier</i></b></dt>
|
||
|
|
<dd>Specify the thread identifier to select. Because some jobs can have identical thread identifiers, this value may not identify a specific job.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.OMTJOB"></a>
|
||
|
|
<h3>Omit jobs (OMTJOB)</h3>
|
||
|
|
<p>Specifies which jobs are omitted from the report. This allows the user to narrow the scope of the report to certain jobs through job omission.
|
||
|
|
</p>
|
||
|
|
<p>The <b>Select jobs</b> prompt (SLTJOB parameter) and <b>Omit jobs</b> prompt (OMTJOB parameter) are mutually exclusive, so the default must be used for at least one of them.
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Job name</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No jobs are excluded from the report.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>job-name</i></b></dt>
|
||
|
|
<dd>Specify the jobs that are excluded from the report. A generic job name may be specified in the form, NAME*.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The job name is not a fully qualified job name. It is the ten-character job name portion of the qualified name. The job number is allowed on this parameter. You cannot mix the use of the job name and job number, one or the other must be used on a given request.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Thread</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All threads are included, unless excluded by some other selection criterion.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>thread-identifier</i></b></dt>
|
||
|
|
<dd>Specify the thread identifier to select. Because some jobs can have identical thread identifiers, this value may not identify a specific job.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.SLTUSRID"></a>
|
||
|
|
<h3>Select users (SLTUSRID)</h3>
|
||
|
|
<p>Specifies a list of up to 50 user names to be included in the report. Only jobs with one of the specified user names are included in the report.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter and the <b>Omit users</b> prompt (OMTUSRID parameter) are mutually exclusive.
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All jobs with user names are included, unless excluded by another selection value.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>user-name</i></b></dt>
|
||
|
|
<dd>Specify the user names of the jobs to select. Because jobs may have identical user names, this value may not identify a specific job. A generic name may be specified for this value. SLTUSRID(user) is equivalent to SLTJOB(*N/user/*N).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>A generic name is a character string that contains one or more characters followed by an asterisk(*), for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic name, the system assumes it to be the complete object name.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.OMTUSRID"></a>
|
||
|
|
<h3>Omit users (OMTUSRID)</h3>
|
||
|
|
<p>Specifies a list of up to 50 user names to be omitted from the report.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter and the <b>Select users</b> prompt (SLTUSRID parameter) are mutually exclusive.
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No jobs are excluded based on the user name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>user-name</i></b></dt>
|
||
|
|
<dd>Specify the user names of the jobs to omit. Because jobs may have identical user names, this value may not identify a specific job. A generic name may be specified for this value. OMTUSRID(user) is equivalent to OMTJOB(*N/user/*N).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>A generic name is a character string that contains one or more characters followed by an asterisk(*), for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic name, the system assumes it to be the complete object name.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.SLTPOOLS"></a>
|
||
|
|
<h3>Select pools (SLTPOOLS)</h3>
|
||
|
|
<p>Specifies a list of up to 64 pools to be included in the report.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter and the <b>Omit pools</b> prompt (OMTPOOLS parameter) are mutually exclusive.
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>Jobs that ran in all pools are included, unless excluded by another selection value.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>storage-pool-identifier</i></b></dt>
|
||
|
|
<dd>Specify the number of a pool to select. Valid values range from 1 through 64.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.OMTPOOLS"></a>
|
||
|
|
<h3>Omit pools (OMTPOOLS)</h3>
|
||
|
|
<p>Specifies a list of up to 64 pools to omit. Jobs that ran in any of the specified pools are excluded from the report.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter and the <b>Select pools</b> prompt (SLTPOOLS parameter) are mutually exclusive.
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>Jobs are not excluded based on their pool.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>storage-pool-identifier</i></b></dt>
|
||
|
|
<dd>Specify the number of a pool to omit. Valid values range from 1 through 64.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.SLTFCNARA"></a>
|
||
|
|
<h3>Select functional areas (SLTFCNARA)</h3>
|
||
|
|
<p>Specifies a list of up to 50 functional areas to select. Only jobs and users identified in one of the functional areas are included in the report.
|
||
|
|
</p>
|
||
|
|
<p>A functional area is a list of job names and/or user names previously defined by the user. More information on functional areas is in the Performance Tools for iSeries book.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter and the <b>Omit functional areas</b> prompt (OMTFCNARA parameter) are mutually exclusive.
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All jobs are included in the report, unless excluded by another selection value.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>functional-area-name</i></b></dt>
|
||
|
|
<dd>Specify the name of a functional area to select.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.OMTFCNARA"></a>
|
||
|
|
<h3>Omit functional areas (OMTFCNARA)</h3>
|
||
|
|
<p>Specifies a list of up to 50 functional areas to omit. Jobs and users identified in any of the functional areas are excluded from the report.
|
||
|
|
</p>
|
||
|
|
<p>A functional area is a list of job names and/or user names previously defined by the user. More information on functional areas is in the Performance Tools for iSeries book.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter and the <b>Select functional areas</b> prompt (SLTFCNARA parameter) are mutually exclusive.
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>Jobs are not excluded from the report based on functional area.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>functional-area-name</i></b></dt>
|
||
|
|
<dd>Specify the name of a functional area to omit.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.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>PRTTNSRPT</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="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="PRTTNSRPT.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="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="PRTTNSRPT.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Printing a Summary Transaction Report</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
PRTTNSRPT MBR(TUESAM)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command produces a summary transaction report. The data input to the report is all the data that exists in member TUESAM in library QPFRDATA. The request is sent to batch. The report output is directed to the output queue specified in the job description, QPFRJOBD.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Printing a Transaction Detail Report</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
PRTTNSRPT MBR(TUESAM) RPTTYPE(*TNSACT) SLTJOB(WS01)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command produces a transaction detail report for the selected job, WS01. The request is sent to batch. The report output is directed to the output queue specified in the job description, QPFRJOBD.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="PRTTNSRPT.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p>None
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#PRTTNSRPT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|