862 lines
34 KiB
HTML
862 lines
34 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 Pool Report (PRTPOLRPT)</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="PRTPOLRPT.Top_Of_Page"></a>
|
|
<h2>Print Pool Report (PRTPOLRPT)</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="#PRTPOLRPT.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#PRTPOLRPT.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#PRTPOLRPT.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="PRTPOLRPT"></a>
|
|
<p>The Print Pool Report (PRTPOLRPT) command produces a pool-oriented report from the performance data collected by Collection Services from the Operations Navigator interface. The report is written to the printer file QPPTITVP. The two sections that comprise the report are subsystem activity and workload activity of storage pools. The information is presented according to interval order. Jobs may be selectively included in the report or excluded from the report, based on a variety of job details and interval times.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="PRTPOLRPT.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="#PRTPOLRPT.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="#PRTPOLRPT.TITLE"><b>TITLE</b></a></td>
|
|
<td valign="top">Report title</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*MBRTXT</u></b>, *BLANK</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="7"><a href="#PRTPOLRPT.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>, *SELECT</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="#PRTPOLRPT.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" rowspan="4"><a href="#PRTPOLRPT.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>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Select jobs</td>
|
|
<td valign="top"><i>Generic name, name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: User</td>
|
|
<td valign="top"><i>Generic name, name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000000-999999</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="4"><a href="#PRTPOLRPT.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>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Omit jobs</td>
|
|
<td valign="top"><i>Generic name, name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: User</td>
|
|
<td valign="top"><i>Generic name, name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000000-999999</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#PRTPOLRPT.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="#PRTPOLRPT.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="#PRTPOLRPT.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</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTPOLRPT.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</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTPOLRPT.SLTSBS"><b>SLTSBS</b></a></td>
|
|
<td valign="top">Select subsystems</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTPOLRPT.OMTSBS"><b>OMTSBS</b></a></td>
|
|
<td valign="top">Omit subsystems</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTPOLRPT.SLTLINE"><b>SLTLINE</b></a></td>
|
|
<td valign="top">Select communications lines</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTPOLRPT.OMTLINE"><b>OMTLINE</b></a></td>
|
|
<td valign="top">Omit communications lines</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTPOLRPT.SLTCTL"><b>SLTCTL</b></a></td>
|
|
<td valign="top">Select control units</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTPOLRPT.OMTCTL"><b>OMTCTL</b></a></td>
|
|
<td valign="top">Omit control units</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTPOLRPT.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="#PRTPOLRPT.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="#PRTPOLRPT.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top"><i>Name</i>, <b><u>PRTPOLRPT</u></b>, *MBR</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#PRTPOLRPT.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="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="PRTPOLRPT.MBR"></a>
|
|
<h3>Member (MBR)</h3>
|
|
<p>Specifies the performance data member used. This name should correspond to the member name specified on the TOMBR parameter of the Create Performance Data (CRTPFRDTA) command.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.TITLE"></a>
|
|
<h3>Report title (TITLE)</h3>
|
|
<p>Specifies the title for the report that is created.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*MBRTXT</u></b></dt>
|
|
<dd>The text of the database member, which contains the performance data, is the report title.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>No title is specified.
|
|
</dd>
|
|
<dt><b><i>'report-title'</i></b></dt>
|
|
<dd>Specify a title of up to 50 characters, enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.PERIOD"></a>
|
|
<h3>Time period for report (PERIOD)</h3>
|
|
<p>Specifies the period of time on which to report. The parameter consists of four elements: a starting time and date, and an ending time and date. Data collected prior to the starting time on the starting date and after the ending time on the ending date is not included in the report.
|
|
</p>
|
|
<p>The symbol *N can be used to designate the default value for any of the four elements.
|
|
</p>
|
|
<p>The possible <b>starting time</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>Data records starting from the beginning of the first day (00:00:00) of the collection period are included.
|
|
</dd>
|
|
<dt><b>*SELECT</b></dt>
|
|
<dd>An interval selection screen is displayed from which you can select one or more intervals for inclusion. This value is valid only in the interactive environment. If this value is used, the remaining values of this parameter (starting time and date and ending time and date) are ignored.
|
|
</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 is specified in 24-hour format 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>All time and date entries must be 2-digits in length, meaning zeros must be included.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>starting date</b> values are:
|
|
</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 format specified by the system value QDATFMT, and if separators are used, as specified by the system value QDATSEP.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>ending time</b> values are:
|
|
</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>The possible <b>ending date</b> values are:
|
|
</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 format specified by the system value QDATFMT, and if separators are used, as specified by the system value QDATSEP.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.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="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.SLTJOB"></a>
|
|
<h3>Select jobs (SLTJOB)</h3>
|
|
<p>Specifies a list of up to 50 jobs to be included in the report. Only specified jobs are included in the report.
|
|
</p>
|
|
<p>Individual jobs are identified by a "job identifier." A job identifier is either the special value *ALL or a qualified name that consists of up to three elements: a job number, a user name, and a job name. Job identifiers are written in the form, job-number/user-name/job-name, but all three elements do not have to be specified. The symbol *N can be used as a placeholder for up to two of the elements of the job identifier.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter and the <b>Omit jobs</b> prompt (OMTJOB parameter) are mutually exclusive.
|
|
</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 in the collected data are included, unless excluded by another selection value.
|
|
</dd>
|
|
<dt><b><i>job-name</i></b></dt>
|
|
<dd>Specify the names of the jobs to select. Because jobs may have identical job names, this value may not identify a specific job. A generic name can be specified for this value.
|
|
</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>
|
|
<dl>
|
|
<dt><b><i>job-number</i></b></dt>
|
|
<dd>Specify the 6-digit number of a job to select. All six digits must be specified, including zeros.
|
|
</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.
|
|
</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="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.OMTJOB"></a>
|
|
<h3>Omit jobs (OMTJOB)</h3>
|
|
<p>Specifies a list of up to 50 jobs to be omitted from the report.
|
|
</p>
|
|
<p>Individual jobs are identified by a "job identifier." A job identifier is either the special value *NONE or a qualified name that consists of up to three elements: a job number, a user name, and a job name. Job identifiers are written in the form, job-number/user-name/job-name, but all three elements do not have to be specified. The symbol *N can be used as a placeholder for up to two of the elements of the job identifier.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter and the <b>Select jobs</b> prompt (SLTJOB parameter) are mutually exclusive.
|
|
</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>Jobs are not excluded based on job identifier.
|
|
</dd>
|
|
<dt><b><i>job-name</i></b></dt>
|
|
<dd>Specify the names of the jobs to omit. Because jobs may have identical job names, this value may not identify a specific job. A generic name can be specified for this value.
|
|
</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>
|
|
<dl>
|
|
<dt><b><i>job-number</i></b></dt>
|
|
<dd>Specify the 6-digit number of a job to omit. All six digits must be specified, including zeros.
|
|
</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.
|
|
</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="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.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="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.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="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.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="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.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="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.SLTSBS"></a>
|
|
<h3>Select subsystems (SLTSBS)</h3>
|
|
<p>Specifies a list of up 50 subsystems to select. Only jobs that ran in one of the specified subsystems are included in the report.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter and the <b>Omit subsystems</b> prompt (OMTSBS 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 in all subsystems are included, unless excluded by another selection value.
|
|
</dd>
|
|
<dt><b><i>subsystem-name</i></b></dt>
|
|
<dd>Specify the name of a subsystem to select.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.OMTSBS"></a>
|
|
<h3>Omit subsystems (OMTSBS)</h3>
|
|
<p>Specifies a list of up to 50 subsystems to omit. Jobs that ran in any of the specified subsystems are excluded from the report.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter and the <b>Select subsystems</b> prompt (SLTSBS 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 subsystem.
|
|
</dd>
|
|
<dt><b><i>subsystem-name</i></b></dt>
|
|
<dd>Specify the name of a subsystem to omit.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.SLTLINE"></a>
|
|
<h3>Select communications lines (SLTLINE)</h3>
|
|
<p>Specifies a list of up to 50 communications lines to select. Only jobs that use a remote device connected through one of the specified communications lines are included in the report.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter and the <b>Omit communications lines</b> prompt (OMTLINE 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>communication-line-name</i></b></dt>
|
|
<dd>Specify the name of a communications line to select. This excludes jobs using remote devices connected through other communications lines, even if the controllers to which those devices are attached are specified on the <b>Select control units</b> prompt (SLTCTL parameter).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.OMTLINE"></a>
|
|
<h3>Omit communications lines (OMTLINE)</h3>
|
|
<p>Specifies a list of up to 50 communications lines to omit. Jobs that use a remote device connected through any of the specified communications lines are excluded from the report.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter and the <b>Select communications lines</b> prompt (SLTLINE 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 communications line.
|
|
</dd>
|
|
<dt><b><i>communication-line-name</i></b></dt>
|
|
<dd>Specify the name of a communications line to omit.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.SLTCTL"></a>
|
|
<h3>Select control units (SLTCTL)</h3>
|
|
<p>Specifies a list of up to 50 communications controllers to select. Only jobs that use a device connected to one of the specified controllers are included in the report.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter and the <b>Omit control units</b> prompt (OMTCTL 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, unless excluded by another selection value.
|
|
</dd>
|
|
<dt><b><i>controller-name</i></b></dt>
|
|
<dd>Specify the name of a communications controller to select.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.OMTCTL"></a>
|
|
<h3>Omit control units (OMTCTL)</h3>
|
|
<p>Specifies a list of up to 50 communications controllers to omit. Jobs that use a device connected to any of the specified controllers are excluded from in the report.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter and the <b>Select control units</b> prompt (SLTCTL 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 communications controllers.
|
|
</dd>
|
|
<dt><b><i>controller-name</i></b></dt>
|
|
<dd>Specify the name of a communications controller to omit.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.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="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.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="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.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>PRTPOLRPT</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="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPOLRPT.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="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="PRTPOLRPT.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Printing a Report</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
PRTPOLRPT MBR(DTA071588A)
|
|
</pre>
|
|
</p>
|
|
<p>This command submits a batch job to print a report on all jobs in all intervals in the member DTA071588A of the performance data files in library QPFRDATA. The report title is taken from the text of that member.
|
|
</p>
|
|
<p><b>Example 2: Selecting Intervals to Include in Report</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
PRTPOLRPT MBR(DTA071588A) PERIOD(*SELECT)
|
|
</pre>
|
|
</p>
|
|
<p>This command submits a job to print a report from the same data, but first shows a display from which the user interactively selects the intervals to include.
|
|
</p>
|
|
<p><b>Example 3: Specifying Data Collection Time Period</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
PRTPOLRPT MBR(DTA071588A) PERIOD((2330)(0130))
|
|
</pre>
|
|
</p>
|
|
<p>This command submits a job to print a report on the data collected from 11:30 PM on the first day of collection through 1:30 AM on the last day of collection. However, if data collection started and ended on the same day, an error message is printed, because the specified ending date and time is before the specified starting date and time.
|
|
</p>
|
|
<p><b>Example 4: Specifying a User ID</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
PRTPOLRPT MBR(DTA071588A) SLTUSRID(D46*) JOBD(*NONE)
|
|
</pre>
|
|
</p>
|
|
<p>This command interactively prints a report for all jobs with a user ID starting with D46.
|
|
</p>
|
|
<p><b>Example 5: Specifying a User ID</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
PRTPOLRPT MBR(DTA071588A) SLTJOB(D46*/*N) JOBD(*NONE)
|
|
</pre>
|
|
</p>
|
|
<p>This command performs the same function as the previous example.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="PRTPOLRPT.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>PFR1010</b></dt>
|
|
<dd>Cannot process request because of missing data.
|
|
</dd>
|
|
<dt><b>PFR3002</b></dt>
|
|
<dd>Cannot print report because of missing data.
|
|
</dd>
|
|
<dt><b>PFR3004</b></dt>
|
|
<dd>Incorrect measurement interval specified.
|
|
</dd>
|
|
<dt><b>PFR3006</b></dt>
|
|
<dd>Measurement interval specified is not valid.
|
|
</dd>
|
|
<dt><b>PFR3101</b></dt>
|
|
<dd>The SLTJOB and OMTJOB parameters are mutually exclusive.
|
|
</dd>
|
|
<dt><b>PFR3102</b></dt>
|
|
<dd>SLTUSRID and OMTUSRID parameters cannot both be specified.
|
|
</dd>
|
|
<dt><b>PFR3103</b></dt>
|
|
<dd>SLTPOOLS and OMTPOOLS parameters cannot both be specified.
|
|
</dd>
|
|
<dt><b>PFR3104</b></dt>
|
|
<dd>SLTSBS and OMTSBS parameters cannot both be specified.
|
|
</dd>
|
|
<dt><b>PFR3105</b></dt>
|
|
<dd>SLTLINE and OMTLINE parameters cannot both be specified.
|
|
</dd>
|
|
<dt><b>PFR3106</b></dt>
|
|
<dd>SLTCTL and OMTCTL parameters cannot both be specified.
|
|
</dd>
|
|
<dt><b>PFR3107</b></dt>
|
|
<dd>SLTFCNARA and OMTFCNARA parameters cannot both be specified.
|
|
</dd>
|
|
<dt><b>PFR3108</b></dt>
|
|
<dd>SLTLOC and OMTLOC parameters cannot both be specified.
|
|
</dd>
|
|
<dt><b>PFR3111</b></dt>
|
|
<dd>Functional area &1 does not exist.
|
|
</dd>
|
|
<dt><b>PFR5501</b></dt>
|
|
<dd>Performance data file(s) are not upward compatible.
|
|
</dd>
|
|
<dt><b>PFR5502</b></dt>
|
|
<dd>Performance data file(s) are not downward compatible.
|
|
</dd>
|
|
<dt><b>PFR9005</b></dt>
|
|
<dd>YAXIS(*TIME) must be specified.
|
|
</dd>
|
|
<dt><b>PFR9042</b></dt>
|
|
<dd>SLTUSER and OMTUSER parameters cannot both be specified.
|
|
</dd>
|
|
<dt><b>PFR9048</b></dt>
|
|
<dd>Cannot display graph because of missing data.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPOLRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|