ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/prtrscrpt.htm

422 lines
15 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!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 Resource Report (PRTRSCRPT)</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="PRTRSCRPT.Top_Of_Page"></a>
<h2>Print Resource Report (PRTRSCRPT)</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="#PRTRSCRPT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#PRTRSCRPT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#PRTRSCRPT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="PRTRSCRPT"></a>
<p>The Print Resource Report (PRTRSCRPT) command produces a device resource usage report from the performance data collected by Collection Services from the Operations Navigator interface. The report, which is written to the printer file QPPTITVR, shows device resource information organized by time interval. Resources may be selected for inclusion in the report or exclusion from the report, based on interval times.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRSCRPT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="PRTRSCRPT.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="#PRTRSCRPT.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="#PRTRSCRPT.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="#PRTRSCRPT.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="#PRTRSCRPT.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="#PRTRSCRPT.TYPE"><b>TYPE</b></a></td>
<td valign="top">Type of information</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 5 repetitions): *DISK, *CMN, *IOP, *LCLWS, *RMTWS</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTRSCRPT.JOB"><b>JOB</b></a></td>
<td valign="top">Job name</td>
<td valign="top"><i>Name</i>, <b><u>PRTRSCRPT</u></b>, *MBR</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#PRTRSCRPT.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="#PRTRSCRPT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="PRTRSCRPT.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="#PRTRSCRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRSCRPT.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="#PRTRSCRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRSCRPT.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="#PRTRSCRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRSCRPT.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="#PRTRSCRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRSCRPT.TYPE"></a>
<h3>Type of information (TYPE)</h3>
<p>Specifies the sections of the report that you want to print.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All sections of the report are printed.
</dd>
<dt><b>*DISK</b></dt>
<dd>Specifies that you want to print the Disk Activity section.
</dd>
<dt><b>*CMN</b></dt>
<dd>Specifies that you want to print the Communications section.
</dd>
<dt><b>*IOP</b></dt>
<dd>Specifies that you want to print the IOP Utilization section.
</dd>
<dt><b>*LCLWS</b></dt>
<dd>Specifies that you want to print the Local Work Stations section.
</dd>
<dt><b>*RMTWS</b></dt>
<dd>Specifies that you want to print the Remote Work Stations section.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRSCRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRSCRPT.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>PRTRSCRPT</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="#PRTRSCRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRSCRPT.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="#PRTRSCRPT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTRSCRPT.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Printing a Report</b>
</p>
<p>
<pre>
PRTRSCRPT MBR(DTA071588A)
</pre>
</p>
<p>This command submits a batch job to print a report on all resources in all intervals in the member DTA071588A of 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>
PRTRSCRPT MBR(DTA071588A) PERIOD(*SELECT)
</pre>
</p>
<p>This command submits a job to print a report from the same data, but first shows a screen from which the user interactively select which intervals to include.
</p>
<p><b>Example 3: Specifying Data Collection Time Period</b>
</p>
<p>
<pre>
PRTRSCRPT 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.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRSCRPT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTRSCRPT.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 &amp;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="#PRTRSCRPT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>