934 lines
35 KiB
HTML
934 lines
35 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 PEX Report (PRTPEXRPT)</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="PRTPEXRPT.Top_Of_Page"></a>
|
|
<h2>Print PEX Report (PRTPEXRPT)</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="#PRTPEXRPT.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#PRTPEXRPT.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#PRTPEXRPT.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="PRTPEXRPT"></a>
|
|
<p>The Print Performance Explorer Report (PRTPEXRPT) command prints a formatted listing of the data that was collected by the performance explorer and saved across a set of physical files in a particular library.
|
|
</p>
|
|
<p><b>Restriction</b>
|
|
</p>
|
|
<ol>
|
|
<li>This command is shipped with PUBLIC *EXCLUDE authority.
|
|
</li>
|
|
<li>You must have read and execute authority to the specified library.
|
|
</li>
|
|
<li>To use this command you must have *SERVICE special authority, or be authorized to the Service Trace function of Operating System/400 through iSeries Navigator's Application Administration support. The Change Function Usage Information (QSYCHFUI) API, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform trace operations.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="PRTPEXRPT.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="#PRTPEXRPT.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="#PRTPEXRPT.LIB"><b>LIB</b></a></td>
|
|
<td valign="top">Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QPEXDATA</u></b></td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTPEXRPT.TYPE"><b>TYPE</b></a></td>
|
|
<td valign="top">Type</td>
|
|
<td valign="top"><b><u>*STATS</u></b>, *TRACE, *PROFILE, *BASIC</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTPEXRPT.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*PRINT</u></b>, *OUTFILE</td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#PRTPEXRPT.OUTFILE"><b>OUTFILE</b></a></td>
|
|
<td valign="top">File to receive output</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 5</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: File to receive output</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#PRTPEXRPT.OUTMBR"><b>OUTMBR</b></a></td>
|
|
<td valign="top">Output member options</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 6</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Member to receive output</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Replace or add records</td>
|
|
<td valign="top">
|
|
<b><u>*REPLACE</u></b>, *ADD</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#PRTPEXRPT.TRACEOPT"><b>TRACEOPT</b></a></td>
|
|
<td valign="top">Trace options</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="4">Optional, Positional 7</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Sort by</td>
|
|
<td valign="top">
|
|
<b><u>*TIMESTAMP</u></b>, *TASK</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Omit completion records</td>
|
|
<td valign="top">
|
|
<b><u>*NO</u></b>, *YES</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Omit Category</td>
|
|
<td valign="top">
|
|
Single values: <b><u>*NONE</u></b><br>Other values (up to 10 repetitions): *PGM, *LICPGM, *ASM, *BASE, *DISK, *DSKSVR, *FAULT, *JOB, *LOCK, *SAR, *MIBRKT, *LICBRKT, *DASD, *DASDSRVR, *PAGEFLT, *RMPR, *RMSL</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTPEXRPT.TRCTYPE"><b>TRCTYPE</b></a></td>
|
|
<td valign="top">Select trace type</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 11 repetitions): *CALLRTN, *BASIC, *DSKIO1, *DSKIO2, *DSKSVR, *DSKSTG, *VRTADR, *PGMACT, *FILEOPEN, *PRFDTA, *TASKSWT</td>
|
|
<td valign="top">Optional, Positional 8</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="7"><a href="#PRTPEXRPT.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, Positional 9</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Start time and date</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>*AVAIL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Starting date</td>
|
|
<td valign="top">
|
|
<i>Date</i>, *CURRENT, <b><u>*BEGIN</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: End time and date</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>*AVAIL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Ending date</td>
|
|
<td valign="top">
|
|
<i>Date</i>, *CURRENT, <b><u>*END</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#PRTPEXRPT.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 10 repetitions): <i>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional, Positional 10</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>, <b><u>*ALL</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000001-999999, <b><u>*ALL</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="4"><a href="#PRTPEXRPT.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 10 repetitions): <i>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional, Positional 11</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>, <b><u>*ALL</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000001-999999, <b><u>*ALL</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#PRTPEXRPT.STATSOPT"><b>STATSOPT</b></a></td>
|
|
<td valign="top">Stats options</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 12</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Sort by</td>
|
|
<td valign="top">
|
|
<i>Integer</i>, *PGMNAME, *INVCNT, <b><u>*CPU</u></b>, *DBSYNCIO, *DBASYNCIO, *NDBSYNCIO, *NDBASYNCIO, *MICALLS, *MIINST, *CUMLCPU, *CUMLDBSYNCIO, *CUMLDBASYNCIO, *CUMLNDBSYNCIO, *CUMLNDBASYNCIO</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Summarize by</td>
|
|
<td valign="top">
|
|
*BLANK, *MODULE, <b><u>*PROGRAM</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#PRTPEXRPT.PROFILEOPT"><b>PROFILEOPT</b></a></td>
|
|
<td valign="top">Profile options</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="4">Optional, Positional 13</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Sort by</td>
|
|
<td valign="top">
|
|
<b><u>*SAMPLECOUNT</u></b>, *ADDRESS</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Summarize by</td>
|
|
<td valign="top">
|
|
*BLANK, *STATEMENT, *PROCEDURE, *MODULE, <b><u>*PROGRAM</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Filter percentage</td>
|
|
<td valign="top">
|
|
0-99, <b><u>0</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTPEXRPT.ORDER"><b>ORDER</b></a></td>
|
|
<td valign="top">Order</td>
|
|
<td valign="top">*ASCENDING, <b><u>*DESCENDING</u></b></td>
|
|
<td valign="top">Optional, Positional 14</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTPEXRPT.NBRTHD"><b>NBRTHD</b></a></td>
|
|
<td valign="top">Number of threads</td>
|
|
<td valign="top">1-64, <b><u>1</u></b>, *CALC</td>
|
|
<td valign="top">Optional, Positional 15</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTPEXRPT.TASKINF"><b>TASKINF</b></a></td>
|
|
<td valign="top">Task information</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *NONE</td>
|
|
<td valign="top">Optional, Positional 16</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="PRTPEXRPT.MBR"></a>
|
|
<h3>Member (MBR)</h3>
|
|
<p>Specifies where the data is located for the report. This is the value that was specified for the SSNID or DTAMBR parameter when the data was saved using the End Performance Explorer (ENDPEX) command. Each database file used by performance explorer when it saved the collected performance data should have a member with the name specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Specify the member name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPEXRPT.LIB"></a>
|
|
<h3>Library (LIB)</h3>
|
|
<p>Specifies the library where the data will be found.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QPEXDATA</u></b></dt>
|
|
<dd>The collected data exists in database files in library QPEXDATA.
|
|
</dd>
|
|
<dt><b><i>library</i></b></dt>
|
|
<dd>Specify the library name which contains the database files that hold the collected performance data.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPEXRPT.TYPE"></a>
|
|
<h3>Type (TYPE)</h3>
|
|
<p>Specifies the type of report to produce. The type of report requested must match the type of data that was collected. If there is a mismatch, an error message is issued. The type of performance data collected is determined by the performance explorer definition that was specified on the Start Performance Explorer (STRPEX) command. Refer to the Add Performance Explorer Definition (ADDPEXDFN) command for more information.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>An exception to the matching of types occurs when you collect data with a definition of TYPE(*TRACE) INTERVAL(nn) BASEVT(*PMCO). When you collect this trace data, you are allowed to specify a report type of *PROFILE. This type of report is known as a *TRACE collection and a *PROFILE report.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*STATS</u></b></dt>
|
|
<dd>A statistics report is produced.
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only for data collected by *STATS mode definitions.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*TRACE</b></dt>
|
|
<dd>A trace report is produced.
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only for data collected by *TRACE mode or *PROFILE PRFTYPE(*JOB) definitions.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*PROFILE</b></dt>
|
|
<dd>A profile report is produced.
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only for data collected by *PROFILE mode definitions or *TRACE TRCTYPE(*PROFILE) definitions.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*BASIC</b></dt>
|
|
<dd>A basic report is produced that includes the definition, run, and task information sections.
|
|
<p>
|
|
<b>Note: </b>This parameter is valid for data collected by any definition.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPEXRPT.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether the output from the command is printed with the job's spooled output or directed to a database file.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only if TYPE(*TRACE) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRINT</u></b></dt>
|
|
<dd>The output is printed with the job's spooled output.
|
|
</dd>
|
|
<dt><b>*OUTFILE</b></dt>
|
|
<dd>The output is directed to the database file specified in the OUTFILE parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPEXRPT.OUTFILE"></a>
|
|
<h3>File to receive output (OUTFILE)</h3>
|
|
<p>Specifies the name of the database file to which the output of the command is directed. If this file does not exist, this command creates a database file in the specified library. The public authority is the same as the create authority specified for the library in which the file is created.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>The file specified here cannot be a DDM file
|
|
</li>
|
|
<li>The model file QAVPETRCI resides in library QPFR.
|
|
</li>
|
|
</ol>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>The library list is used to locate the output file. If the output file is not found, one is created in the current library. If no current library exists, the output file is created in the QGPL library.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the specified output file. If no library is specified as the current library for the job, the library QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library where the output file is located.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>database-file-name</i></b></dt>
|
|
<dd>Specify the name of the output file that receives the output of the command.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPEXRPT.OUTMBR"></a>
|
|
<h3>Output member options (OUTMBR)</h3>
|
|
<p>Specifies the name of the database file member to which the output is directed.
|
|
</p>
|
|
<p><b>Element 1: Member to Receive Output</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified on the OUTFILE parameter. If the member already exists, the user has the option to add new records to the end of the existing member or clear the member and then add the new records.
|
|
</dd>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Specify the file member that receives the output. If OUTMBR(member-name) is specified and the member does not exist, the system creates it. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Operation to Perform on Member</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REPLACE</u></b></dt>
|
|
<dd>The system clears the existing member and adds the new records.
|
|
</dd>
|
|
<dt><b>*ADD</b></dt>
|
|
<dd>The system adds the new records to the end of the existing records.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPEXRPT.TRACEOPT"></a>
|
|
<h3>Trace options (TRACEOPT)</h3>
|
|
<p>Specifies how to organize a trace (*TRACE) report. Records are ordered based on the value specified for the ORDER parameter.
|
|
</p>
|
|
<p><b>Element 1: Sort by </b>
|
|
</p>
|
|
<p>This value represents how the data is ordered.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*TIMESTAMP</u></b></dt>
|
|
<dd>The records are listed in time stamp order.
|
|
</dd>
|
|
<dt><b>*TASK</b></dt>
|
|
<dd>The records are listed in time stamp order within each job/task.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Omit completion records </b>
|
|
</p>
|
|
<p>This provides a mechanism to reduce large amounts of data to enable more efficient review of the data.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>All records associated with this performance data collection session are included in the report.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>All completion records are excluded from the report. This is helpful if there is a large amount of data to review.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Omit category </b>
|
|
</p>
|
|
<p>Specify one or more categories to be omitted from the generated report.
|
|
</p>
|
|
<p>The possible single value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No categories are omitted.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible omitted category values are
|
|
</p>
|
|
<dl>
|
|
<dt><b>*PGM</b></dt>
|
|
<dd>Exclude the category for the program call flow events.
|
|
</dd>
|
|
<dt><b>*LICPGM</b></dt>
|
|
<dd>Exclude the category for the Licensed Internal Code call flow events.
|
|
</dd>
|
|
<dt><b>*ASM</b></dt>
|
|
<dd>Exclude the category for the auxiliary storage management events.
|
|
</dd>
|
|
<dt><b>*BASE</b></dt>
|
|
<dd>Exclude the category for the base events, which includes tasking events.
|
|
</dd>
|
|
<dt><b>*DISK</b></dt>
|
|
<dd>Exclude the category for the direct access storage device events.
|
|
</dd>
|
|
<dt><b>*DSKSVR</b></dt>
|
|
<dd>Exclude the category for the disk server events.
|
|
</dd>
|
|
<dt><b>*FAULT</b></dt>
|
|
<dd>Exclude the category for the page fault events.
|
|
</dd>
|
|
<dt><b>*JOB</b></dt>
|
|
<dd>Exclude the category for the job or process management events.
|
|
</dd>
|
|
<dt><b>*LOCK</b></dt>
|
|
<dd>Exclude the category for the seize lock events.
|
|
</dd>
|
|
<dt><b>*SAR</b></dt>
|
|
<dd>Exclude the category for the segment address register events.
|
|
</dd>
|
|
<dt><b>*MIBRKT</b></dt>
|
|
<dd>Exclude the category for the machine interface program bracketing events.
|
|
</dd>
|
|
<dt><b>*LICBRKT</b></dt>
|
|
<dd>Exclude the category for the Licensed Internal Code bracketing events.
|
|
</dd>
|
|
<dt><b>*DASD</b></dt>
|
|
<dd>Exclude the category for the direct access storage device events.
|
|
</dd>
|
|
<dt><b>*DASDSRVR</b></dt>
|
|
<dd>Exclude the category for the DASD server events.
|
|
</dd>
|
|
<dt><b>*PAGEFLT</b></dt>
|
|
<dd>Exclude the category for the page fault events.
|
|
</dd>
|
|
<dt><b>*RMPR</b></dt>
|
|
<dd>Exclude the category for the resource management process management events.
|
|
</dd>
|
|
<dt><b>*RMSZ</b></dt>
|
|
<dd>Exclude the category for the resource management seize lock events.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPEXRPT.TRCTYPE"></a>
|
|
<h3>Select trace type (TRCTYPE)</h3>
|
|
<p>Specifies which trace events to include in the output. The options possible are the same options found on the Add Performance Explorer Definition (ADDPEXDFN) command.
|
|
</p>
|
|
<p>The possible single value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Include all trace events in the output.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible trace type values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b>*CALLRTN</b></dt>
|
|
<dd>Specifies that call return events are included in the output. Call return events occur when a program is entered and exited as well as when certain machine instructions are started and completed.
|
|
</dd>
|
|
<dt><b>*BASIC</b></dt>
|
|
<dd>Specifies that events relative to general performance analysis are included in the output.
|
|
</dd>
|
|
<dt><b>*DSKIO1</b></dt>
|
|
<dd>Specifies that events associated with disk input/output operations are included in the output.
|
|
</dd>
|
|
<dt><b>*DSKIO2</b></dt>
|
|
<dd>Specifies that events associated with the disk input/output operations plus higher level requests to do input/output operations are included in the output.
|
|
</dd>
|
|
<dt><b>*DSKSVR</b></dt>
|
|
<dd>Specifies that events associated with disk server operations are included in the output.
|
|
</dd>
|
|
<dt><b>*DSKSTG</b></dt>
|
|
<dd>Specifies that events associated with disk storage consumption are included in the output.
|
|
</dd>
|
|
<dt><b>*VRTADR</b></dt>
|
|
<dd>Specifies that events associated with virtual address assignment are included in the output.
|
|
</dd>
|
|
<dt><b>*PGMACT</b></dt>
|
|
<dd>Specifies that events associated with program activations and deactivations are included in the output.
|
|
</dd>
|
|
<dt><b>*FILEOPEN</b></dt>
|
|
<dd>Specifies that events associated with file opens are included in the output.
|
|
</dd>
|
|
<dt><b>*PFRDTA</b></dt>
|
|
<dd>Specifies that events associated with CPU instruction profiling are included in the output.
|
|
<p>
|
|
<b>Note: </b>The *PFRDTA value provides you with a detailed list of files. To receive a list in a summary format, as an alternative, you can specify PRTPEXRPT TYPE(*PROFILE).
|
|
</p>
|
|
</dd>
|
|
<dt><b>*TASKSWT</b></dt>
|
|
<dd>Specifies that events associated with tasking are included in the output.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPEXRPT.PERIOD"></a>
|
|
<h3>Time period for report (PERIOD)</h3>
|
|
<p>Specifies the period of time on which to report. The parameter consists of two lists of two elements each. 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 possible <b>starting time</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
|
<dd>The recorded data that is available for the specified starting date is shown.
|
|
</dd>
|
|
<dt><b><i>start-time</i></b></dt>
|
|
<dd>Specify the starting time on the specified starting date that indicates the recorded data to be shown. The time is specified in 24-hour format with or without a time separator:
|
|
<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>*CURRENT</u></b></dt>
|
|
<dd>The recorded data for the current day and between the specified starting and ending times (if specified) is shown.
|
|
</dd>
|
|
<dt><b>*BEGIN</b></dt>
|
|
<dd>The recorded data from the beginning of the log is shown.
|
|
</dd>
|
|
<dt><b><i>start-date</i></b></dt>
|
|
<dd>Specify the date printed. 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>*AVAIL</u></b></dt>
|
|
<dd>The recorded data that is available for the specified ending date is shown.
|
|
</dd>
|
|
<dt><b><i>end-time</i></b></dt>
|
|
<dd>Specify the ending time for the specified ending date that determines the recorded date that is printed.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>ending date</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>The current day is the last day for which recorded data is shown.
|
|
</dd>
|
|
<dt><b>*END</b></dt>
|
|
<dd>The last day on which data was logged is shown. If PERIOD(*END) is specified, a time value other than *AVAIL for end time is ignored.
|
|
</dd>
|
|
<dt><b><i>end-date</i></b></dt>
|
|
<dd>Specify the ending date for which recorded data is to be printed. 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="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPEXRPT.SLTJOB"></a>
|
|
<h3>Select jobs (SLTJOB)</h3>
|
|
<p>Specifies which jobs to include from the report. This allows the user to narrow the scope of the performance explorer report by selecting specific jobs.
|
|
</p>
|
|
<p>The SLTJOB and OMTJOB parameters are mutually exclusive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL:</u></b></dt>
|
|
<dd>All jobs in the performance explorer database are included.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>Job Identifier </b>values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>job-name:</i></b></dt>
|
|
<dd>Specify the name of the job to be included in the performance explorer report.
|
|
</dd>
|
|
<dt><b><i>generic*-job-name:</i></b></dt>
|
|
<dd>Specify the generic name of the job to be included in the performance explorer report.
|
|
</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>
|
|
<p>The possible <b>Job User Name Qualifier </b>values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL:</u></b></dt>
|
|
<dd>All jobs that match the specified job name are included.
|
|
</dd>
|
|
<dt><b><i>user-name:</i></b></dt>
|
|
<dd>Specify the name of the user of the job to be included.
|
|
</dd>
|
|
<dt><b><i>generic*-user-name:</i></b></dt>
|
|
<dd>Specify the generic user name of the jobs to be included.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>Job Number Qualifier </b>values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL:</u></b></dt>
|
|
<dd>All jobs that match the specified job name and user name are included.
|
|
</dd>
|
|
<dt><b><i>job-number:</i></b></dt>
|
|
<dd>Specify the job number to further qualify the job name and user name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPEXRPT.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 performance explorer report by omitting specific jobs.
|
|
</p>
|
|
<p>The SLTJOB and OMTJOB parameters are mutually exclusive. You must use the default for one of these parameters.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE:</u></b></dt>
|
|
<dd>No jobs in the performance explorer database are omitted.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>Job Identifier </b>values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>job-name:</i></b></dt>
|
|
<dd>Specify the name of the job to be omitted in the performance explorer report.
|
|
</dd>
|
|
<dt><b><i>generic*-job-name:</i></b></dt>
|
|
<dd>Specify the generic name of the job to be omitted in the performance explorer report.
|
|
</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>
|
|
<p>The possible <b>Job User Name Qualifier </b>values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL:</u></b></dt>
|
|
<dd>All jobs that match the specified job name will be omitted.
|
|
</dd>
|
|
<dt><b><i>user-name:</i></b></dt>
|
|
<dd>Specify the name of the user of the job to be omitted.
|
|
</dd>
|
|
<dt><b><i>generic*-user-name:</i></b></dt>
|
|
<dd>Specify the generic user name of the jobs to be omitted.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>Job Number Qualifier </b>values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL:</u></b></dt>
|
|
<dd>All jobs that match the specified job name and user name will be omitted.
|
|
</dd>
|
|
<dt><b><i>job-number:</i></b></dt>
|
|
<dd>Specify the job number to further qualify the job name and user name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPEXRPT.STATSOPT"></a>
|
|
<h3>Stats options (STATSOPT)</h3>
|
|
<p>Specifies how to organize a statistics (*STATS) report. Records are ordered based on the value specified for the ORDER parameter.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is ignored if, on the ADDPEXDFN command, you specified TYPE(*STATS) and DTAORG(*HIER). The parameter is ignored to retain the parent-child relationship that was collected for this definition.
|
|
</p>
|
|
<p><b>Element 1: Sort by </b>
|
|
</p>
|
|
<p>Specifies how the records are arranged in the report.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CPU</u></b></dt>
|
|
<dd>Arrange the output by amount of CPU time.
|
|
</dd>
|
|
<dt><b>*PGMNAME</b></dt>
|
|
<dd>Arrange the output by program name.
|
|
</dd>
|
|
<dt><b>*INVCNT</b></dt>
|
|
<dd>Arrange the output by number of times program or procedure is called.
|
|
</dd>
|
|
<dt><b>*DBSYNCIO</b></dt>
|
|
<dd>Arrange the output by amount of physical database synchronous I/O.
|
|
</dd>
|
|
<dt><b>*DBASYNCIO</b></dt>
|
|
<dd>Arrange the output by amount of physical database asynchronous I/O.
|
|
</dd>
|
|
<dt><b>*NDBSYNCIO</b></dt>
|
|
<dd>Arrange the output by amount of physical non-database synchronous I/O.
|
|
</dd>
|
|
<dt><b>*NDBASYNCIO</b></dt>
|
|
<dd>Arrange the output by amount of physical non-database asynchronous I/O.
|
|
</dd>
|
|
<dt><b>*MICALLS</b></dt>
|
|
<dd>Arrange the output by number of MI calls.
|
|
</dd>
|
|
<dt><b>*MIINST</b></dt>
|
|
<dd>Arrange the output by MI instruction name.
|
|
</dd>
|
|
<dt><b>*CUMLCPU</b></dt>
|
|
<dd>Arrange the output by cumulative CPU value.
|
|
</dd>
|
|
<dt><b>*CUMLDBSYNCIO</b></dt>
|
|
<dd>Arrange the output by cumulative amount of physical database synchronous I/O.
|
|
</dd>
|
|
<dt><b>*CUMLDNASYNCIO</b></dt>
|
|
<dd>Arrange the output by cumulative amount of physical database asynchronous I/O.
|
|
</dd>
|
|
<dt><b>*CUMLNDBSYNCIO</b></dt>
|
|
<dd>Arrange the output by cumulative amount of physical non-database synchronous I/O.
|
|
</dd>
|
|
<dt><b>*CUMLNDBASYNCIO</b></dt>
|
|
<dd>Arrange the output by cumulative amount of physical non-database asynchronous I/O.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Summarize by </b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PROGRAM</u></b></dt>
|
|
<dd>The data is summarized at the program level.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>The data is not summarized.
|
|
</dd>
|
|
<dt><b>*MODULE</b></dt>
|
|
<dd>The data is summarized at the module level.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPEXRPT.PROFILEOPT"></a>
|
|
<h3>Profile options (PROFILEOPT)</h3>
|
|
<p>Specifies how to organize a profile (*PROFILE) report. Records are ordered based on the value specified for the ORDER parameter.
|
|
</p>
|
|
<p><b>Element 1: Sort by </b>
|
|
</p>
|
|
<p>Specifies how the records are arranged in the report
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAMPLECOUNT</u></b></dt>
|
|
<dd>Arrange the output relative to the sample count.
|
|
</dd>
|
|
<dt><b>*ADDRESS</b></dt>
|
|
<dd>Arrange the output relative to the sampled address.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Summarize By </b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PROGRAM</u></b></dt>
|
|
<dd>Summarize the data at the program level.
|
|
</dd>
|
|
<dt><b>*STATEMENT</b></dt>
|
|
<dd>Summarize the data at the statement level.
|
|
</dd>
|
|
<dt><b>*PROCEDURE</b></dt>
|
|
<dd>Summarize the data at the procedure level.
|
|
</dd>
|
|
<dt><b>*MODULE</b></dt>
|
|
<dd>Summarize the data at the module level.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>No summary records are provided.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Filter percentage</b>
|
|
</p>
|
|
<p>This provides a filter to eliminate the insignificant records. For example, an entry of 10 would omit all the records that contain less than 10% of the samples taken during the collection.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>0</u></b></dt>
|
|
<dd>No records are omitted from the report.
|
|
</dd>
|
|
<dt><b><i>filter-percentage</i></b></dt>
|
|
<dd>Specify a number in the range of 0 to 100.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPEXRPT.ORDER"></a>
|
|
<h3>Order (ORDER)</h3>
|
|
<p>Specifies how the data should be ordered in the report.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DESCENDING</u></b></dt>
|
|
<dd>The data records are ordered in descending order. If records are sorted by a numeric field, records are ordered from largest to smallest. If records are sorted by a name field, records are in reverse alphabetical order, for example, from Z to A.
|
|
</dd>
|
|
<dt><b>*ASCENDING</b></dt>
|
|
<dd>The data records are in ascending order. If records are sorted by a numeric field, records will be ordered from smallest to largest. If records are sorted by a name field, records are in alphabetical order, for example, from A to Z).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPEXRPT.NBRTHD"></a>
|
|
<h3>Number of threads (NBRTHD)</h3>
|
|
<p>Specifies the number of concurrent threads that the PRTPEXRPT command uses to print the data. Specifying a number greater than 1 allows the PRTPEXRPT command to take advantage of available CPU cycles, especially on a multi-processor system. While this may speed up the command processing, it may also degrade the performance of other jobs on the system. You can minimize this impact by changing the priority of the job that runs the PRTPEXRPT command to a higher number. You should also verify that the disk subsystem can handle the additional threads. Typically, the PRTPEXRPT command requires one disk arm for each active thread.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If you specify OUTPUT (*PRINT), the number of spooled files is equal to NBRTHD (one spooled file per thread).
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CALC:</u></b></dt>
|
|
<dd>The system calculates a reasonable number of threads to do the command processing which does not use excessive system resources. Usually this is one or two threads for each available processor. If this command is run in an interactive job, *CALC uses only one thread.
|
|
</dd>
|
|
<dt><b><i> number-of-threads:</i></b></dt>
|
|
<dd>Specify the number of threads for the PRTPEXRPT command to use to process the collected data.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTPEXRPT.TASKINF"></a>
|
|
<h3>Task information (TASKINF)</h3>
|
|
<p>Specifies whether the task information section is to be printed or not.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The task information section will be printed and will include details for all jobs and tasks available in the collected data. If ADDPEXDFN LSTALLJOB(*YES) was specified in the definition used to collect this data, then details for all jobs and tasks on the system during the time of the collection will be printed.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>The task information section will not be printed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="PRTPEXRPT.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Printing a Statistics Report</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
PRTPEXRPT MBR(SAMPLE) LIBRARY(SAMPLELIB)
|
|
TYPE(*STATS) STATSOPT(*INVCNT *MODULE)
|
|
</pre>
|
|
</p>
|
|
<p>This command prints a report based on data members named SAMPLE in library SAMPLELIB. The data is arranged in descending order based on invocation counts and is summarized at the module level.
|
|
</p>
|
|
<p><b>Example 2: Printing a Profile Report</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
PRTPEXRPT MBR(SAMPLE2) TYPE(*PROFILE)
|
|
PROFILEOPT(*SAMPLECOUNT *PROGRAM)
|
|
ORDER(*DESCENDING)
|
|
</pre>
|
|
</p>
|
|
<p>This command prints a report based on data members named SAMPLE2 in the default library, QPEXDATA. The data is arranged in descending order based on the sample count and is summarized at the program level.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="PRTPEXRPT.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p>None
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTPEXRPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|