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

452 lines
17 KiB
HTML
Raw Permalink 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 Activity Report (PRTACTRPT)</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="PRTACTRPT.Top_Of_Page"></a>
<h2>Print Activity Report (PRTACTRPT)</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="#PRTACTRPT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#PRTACTRPT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#PRTACTRPT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="PRTACTRPT"></a>
<p>The Print Activity Report (PRTACTRPT) command generates reports based on the data collected by the Work With System Activity (WRKSYSACT) command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTACTRPT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="PRTACTRPT.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="#PRTACTRPT.MBR"><b>MBR</b></a></td>
<td valign="top">Member</td>
<td valign="top"><i>Name</i>, <b><u>QAITMON</u></b></td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#PRTACTRPT.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="#PRTACTRPT.TITLE"><b>TITLE</b></a></td>
<td valign="top">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="#PRTACTRPT.RPTTYPE"><b>RPTTYPE</b></a></td>
<td valign="top">Report type</td>
<td valign="top"><b><u>*SUMMARY</u></b>, *DETAIL, *ALL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="7"><a href="#PRTACTRPT.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="#PRTACTRPT.SEQ"><b>SEQ</b></a></td>
<td valign="top">Sequence</td>
<td valign="top">*JOBTASK, *USER, *PTY, <b><u>*CPU</u></b>, *TOTALIO, *SYNCIO, *ASYNCIO, *FAULT, *SDBREAD, *SDBWRITE, *SNDBREAD, *SNDBWRITE, *ADBREAD, *ADBWRITE, *ANDBREAD, *ANDBWRITE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTACTRPT.NBRJOBS"><b>NBRJOBS</b></a></td>
<td valign="top">Number of jobs</td>
<td valign="top">1-32767, <b><u>10</u></b>, *ALL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTACTRPT.JOB"><b>JOB</b></a></td>
<td valign="top">Job name</td>
<td valign="top"><i>Name</i>, <b><u>PRTACTRPT</u></b>, *MBR</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#PRTACTRPT.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="#PRTACTRPT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="PRTACTRPT.MBR"></a>
<h3>Member (MBR)</h3>
<p>Specifies the member where the performance data was saved by the Work with System Activity (WRKSYSACT) command.
</p>
<dl>
<dt><b><u>QAITMON</u></b></dt>
<dd>The standard member name, QAITMON, is used.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Specify the name of the member that contains the performance data.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTACTRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTACTRPT.LIB"></a>
<h3>Library (LIB)</h3>
<p>Specifies the library where the performance data file, QAITMON, is stored.
</p>
<dl>
<dt><b><u>QPFRDATA</u></b></dt>
<dd>The performance data is stored 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 data file is stored.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTACTRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTACTRPT.TITLE"></a>
<h3>Title (TITLE)</h3>
<p>Specifies the title for the activity report that is generated.
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>No title is placed on the activity report.
</dd>
<dt><b><i>'report-title'</i></b></dt>
<dd>Specify a title for the activity report. Specify up to 50 characters enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTACTRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTACTRPT.RPTTYPE"></a>
<h3>Report type (RPTTYPE)</h3>
<p>Specifies the type of activity report to be generated.
</p>
<dl>
<dt><b><u>*SUMMARY</u></b></dt>
<dd>Lists the top ten entries, as measured over the entire time frame specified by the PERIOD parameter, according to processing unit utilization and number of I/O operations performed.
</dd>
<dt><b>*DETAIL</b></dt>
<dd>For each interval specified by the PERIOD parameter, the number of entries specified by the NBRJOBS parameter are listed in the order specified by the SEQ parameter.
</dd>
<dt><b>*ALL</b></dt>
<dd>Generates the summary activity report and the detailed activity report.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTACTRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTACTRPT.PERIOD"></a>
<h3>Time period for report (PERIOD)</h3>
<p>Specifies the time period for the report. The following values can be coded in this parameter, which contains two lists of two elements each. Data collected before the specified starting time and date and after the specified ending time and date is not shown. If no values are specified, the following values are assumed:
</p>
<p>PERIOD((*FIRST*FIRST) (*LAST*LAST))
</p>
<p>The possible <b>starting time</b> values are:
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The collected data that is available for the first interval on the specified starting date is included in the report.
</dd>
<dt><b><i>start-time</i></b></dt>
<dd>Specify the time at which or after which the data must have been collected to be included 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>The possible <b>starting date</b> values are:
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The collected data that is available on or after the specified starting time on the first day of the performance data collection is included in the report.
</dd>
<dt><b><i>start-date</i></b></dt>
<dd>Specify the starting date on which or after which the data must have been collected to be included in the report. The date must be entered in the same format as specified for the job.
</dd>
</dl>
<p>The possible <b>ending time</b> values are:
</p>
<dl>
<dt><b><u>*LAST</u></b></dt>
<dd>The collected data that is available through the last interval on the specified ending date is included in the report.
</dd>
<dt><b><i>end-time</i></b></dt>
<dd>Specify the time before which the data must have been collected to be included 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>
<p>The possible <b>ending date</b> values are:
</p>
<dl>
<dt><b><u>*LAST</u></b></dt>
<dd>The collected data that is available up to the specified ending time on the last day of the performance data collection is included in the report.
</dd>
<dt><b><i>end-date</i></b></dt>
<dd>Specify the ending date on which or before which the data must have been collected to be included 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="#PRTACTRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTACTRPT.SEQ"></a>
<h3>Sequence (SEQ)</h3>
<p>Specifies the field by which the jobs and tasks are ranked and then listed on the detailed activity report. This parameter is valid only when *DETAIL or *ALL is specified for the RPTTYPE parameter.
</p>
<dl>
<dt><b><u>*CPU</u></b></dt>
<dd>List the entries in descending order according to processing unit utilization.
</dd>
<dt><b>*JOBTASK</b></dt>
<dd>List the entries alphabetically according to the job or task name.
</dd>
<dt><b>*USER</b></dt>
<dd>List the entries alphabetically according to the user profile.
</dd>
<dt><b>*PTY</b></dt>
<dd>Lists the entries in descending order according to priority.
</dd>
<dt><b>*TOTALIO</b></dt>
<dd>Lists the entries in descending order according to the total number of synchronous and asynchronous I/O operations performed.
</dd>
<dt><b>*SYNCIO</b></dt>
<dd>List the entries in descending order according to the total number of synchronous I/O operations performed.
</dd>
<dt><b>*ASYNCIO</b></dt>
<dd>List the entries in descending order according to the total number of asynchronous I/O operations initiated.
</dd>
<dt><b>*FAULT</b></dt>
<dd>List the entries in descending order according to the number of Process Access Group faults which occurred.
</dd>
<dt><b>*SDBREAD</b></dt>
<dd>List the entries in descending order according to the number of synchronous database read operations performed.
</dd>
<dt><b>*SDBWRITE</b></dt>
<dd>List the entries in descending order according to the number of synchronous database write operations performed.
</dd>
<dt><b>*SNDBREAD</b></dt>
<dd>List the entries in descending order according to the number of synchronous non database read operations performed.
</dd>
<dt><b>*SNDBWRITE</b></dt>
<dd>List the entries in descending order according to the number of synchronous non database write operations performed.
</dd>
<dt><b>*ADBREAD</b></dt>
<dd>List the entries in descending order according to the number of asynchronous database read operations initiated.
</dd>
<dt><b>*ADBWRITE</b></dt>
<dd>List the entries in descending order according to the number of asynchronous database write operations initiated.
</dd>
<dt><b>*ANDBREAD</b></dt>
<dd>List the entries in descending order according to the number of asynchronous non database read operations initiated.
</dd>
<dt><b>*ANDBWRITE</b></dt>
<dd>List the entries in descending order according to the number of asynchronous non database write operations initiated.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTACTRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTACTRPT.NBRJOBS"></a>
<h3>Number of jobs (NBRJOBS)</h3>
<p>Specifies the number of entries to be listed for each interval in the detailed activity report. This parameter is valid only when *DETAIL or *ALL is specified for the RPTTYPE parameter.
</p>
<dl>
<dt><b><u>10</u></b></dt>
<dd>List ten entries for each interval.
</dd>
<dt><b><i>number-of-jobs</i></b></dt>
<dd>Specify the number of entries to be listed for each interval.
</dd>
<dt><b>*ALL</b></dt>
<dd>List all the entries contained in the collected data.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTACTRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTACTRPT.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>PRTACTRPT</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="#PRTACTRPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTACTRPT.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="#PRTACTRPT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTACTRPT.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Generating a Summary Report</b>
</p>
<p>
<pre>
PRTACTRPT
</pre>
</p>
<p>This command submits a batch job that generates a summary activity report using the performance data found in the default member QAITMON located in the default library QPFRDATA. The report covers the entire measurement period, and the title of the report is left blank.
</p>
<p><b>Example 2: Generating a Summary and Detailed Activity Report</b>
</p>
<p>
<pre>
PRTACTRPT MBR(JUNE01) TITLE('Activity Report for June 1st')
RPTTYPE(*ALL) SEQ(*CPU)
</pre>
</p>
<p>This command submits a batch job that generates both a summary and a detailed activity report. The performance data comes from member JUNE01 located in the default library QPFRDATA. The report covers the entire measurement period, and the title of the report is 'Activity Report for June 1st'. The detailed activity report lists ten entries in descending order according to CPU utilization for each interval.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTACTRPT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTACTRPT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>PFR7010</b></dt>
<dd>No data in member to print.
</dd>
<dt><b>PFR7017</b></dt>
<dd>Cannot print activity report.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTACTRPT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>