425 lines
17 KiB
HTML
425 lines
17 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>Create Performance Data (CRTPFRDTA)</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="CRTPFRDTA.Top_Of_Page"></a>
|
|
<h2>Create Performance Data (CRTPFRDTA)</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="#CRTPFRDTA.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CRTPFRDTA.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CRTPFRDTA.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CRTPFRDTA"></a>
|
|
<p>The Create Performance Data (CRTPFRDTA) command creates a set of performance database files from performance information stored in a management collection (*MGTCOL) object. For more information about the database files, see the Performance topic in the iSeries Information Center at the Web site: http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p>Performance database files and file members will be created as needed based on the data contained in the management collection object and the information requested on this command. If database files already exist and the requested member exists in any of them, the member will be cleared before the collection is generated.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CRTPFRDTA.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" rowspan="3"><a href="#CRTPFRDTA.FROMMGTCOL"><b>FROMMGTCOL</b></a></td>
|
|
<td valign="top">From collection</td>
|
|
<td valign="top">Single values: *ACTIVE<br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: From collection</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>QPFRDATA</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CRTPFRDTA.TOMBR"><b>TOMBR</b></a></td>
|
|
<td valign="top">To member</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*FROMMGTCOL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTPFRDTA.TOLIB"><b>TOLIB</b></a></td>
|
|
<td valign="top">To library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*FROMMGTCOL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTPFRDTA.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *FROMMGTCOL, *GEN, *BLANK</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTPFRDTA.CGY"><b>CGY</b></a></td>
|
|
<td valign="top">Categories to process</td>
|
|
<td valign="top">Single values: <b><u>*FROMMGTCOL</u></b><br>Other values (up to 26 repetitions): <i>Name</i>, *APPN, *CMNBASE, *CMNSAP, *CMNSTN, *DISK, *DOMINO, *DPS, *HDWCFG, *HTTP, *IOPBASE, *IPCS, *JOBMI, *JOBOS, *LCLRSP, *LPAR, *POOL, *POOLTUNE, *SNA, *SNADS, *SUBSYSTEM, *SYSBUS, *SYSCPU, *SYSLVL, *TCPBASE, *TCPIFC, *USRTNS</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTPFRDTA.INTERVAL"><b>INTERVAL</b></a></td>
|
|
<td valign="top">Time interval (in minutes)</td>
|
|
<td valign="top"><b><u>*FROMMGTCOL</u></b>, 0.25, 0.5, 1.0, 5.0, 15.0, 30.0, 60.0</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CRTPFRDTA.FROMTIME"><b>FROMTIME</b></a></td>
|
|
<td valign="top">Starting date and time</td>
|
|
<td valign="top">Single values: <b><u>*FROMMGTCOL</u></b><br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Starting date</td>
|
|
<td valign="top">
|
|
<i>Date</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Starting time</td>
|
|
<td valign="top">
|
|
<i>Time</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CRTPFRDTA.TOTIME"><b>TOTIME</b></a></td>
|
|
<td valign="top">Ending date and time</td>
|
|
<td valign="top">Single values: <b><u>*FROMMGTCOL</u></b>, *ACTIVE<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Ending date</td>
|
|
<td valign="top">
|
|
<i>Date</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Ending time</td>
|
|
<td valign="top">
|
|
<i>Time</i></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CRTPFRDTA.FROMMGTCOL"></a>
|
|
<h3>From collection (FROMMGTCOL)</h3>
|
|
<p>Specifies the management collection from which a set of performance database files is to be created.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ACTIVE</b></dt>
|
|
<dd>The currently active collection object will be used.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: From collection</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the management collection object that is to be used.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QPFRDATA</u></b></dt>
|
|
<dd>IBM-supplied performance data library QPFRDATA is to be used to locate the management collection.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library for the management collection.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTPFRDTA.TOMBR"></a>
|
|
<h3>To member (TOMBR)</h3>
|
|
<p>Specifies the database file member to which the output data is to be written. If a member by this name does not exist in each performance database file, one will be created with the specified name.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FROMMGTCOL</u></b></dt>
|
|
<dd>The name of the management collection object is used as the performance database file member name.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the member to which the output should be written.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTPFRDTA.TOLIB"></a>
|
|
<h3>To library (TOLIB)</h3>
|
|
<p>Specifies the library where the database files for performance data are to exist. Each file that is not found in the specified library is automatically created in that library.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FROMMGTCOL</u></b></dt>
|
|
<dd>The performance database files are located or created in the same library as the management collection object (FROMMGTCOL parameter).
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library where the performance database files are located or should be created.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTPFRDTA.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text to be used for each member across the set of performance data base files associated with the collection.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*FROMMGTCOL</b></dt>
|
|
<dd>Text associated with the management collection object is used as the member text.
|
|
</dd>
|
|
<dt><b>*GEN</b></dt>
|
|
<dd>The following text will be generated - "Created from <collection name> in library <library name>". If the member already exists, no change is made.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>No text is specified.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify no more that 50 characters of text, enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTPFRDTA.CGY"></a>
|
|
<h3>Categories to process (CGY)</h3>
|
|
<p>Specifies the categories in the management collection object which will be processed into database files.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FROMMGTCOL</u></b></dt>
|
|
<dd>All of the categories present in the management collection object will be processed into database files.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 25 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>category-name</i></b></dt>
|
|
<dd>Specify the name of the category of performance information to be processed from the management collection object. Multiple category names may be specified. Valid category names are:
|
|
<p>
|
|
<pre>
|
|
Name Description
|
|
------------- ---------------------------
|
|
*APPN APPN
|
|
*CMNBASE Communications (Base)
|
|
*CMNSAP Communications (SAP)
|
|
*CMNSTN Communications (Station)
|
|
*DISK Disk
|
|
*DOMINO Domino for iSeries
|
|
*DPS Data port services
|
|
*HDWCFG Hardware
|
|
*HTTP HTTP Server (powered by Apache)
|
|
*IOPBASE Input/output processors (Base)
|
|
*IPCS Network server
|
|
*JOBMI Jobs (MI tasks and threads)
|
|
*JOBOS Jobs (operating system)
|
|
*LCLRSP Local response time
|
|
*LPAR Logical partition
|
|
*POOL Pool
|
|
*POOLTUNE Pool tuning
|
|
*SNA SNA
|
|
*SNADS SNADS
|
|
*SUBSYSTEM Subsystem
|
|
*SYSBUS System Bus
|
|
*SYSCPU System CPU
|
|
*SYSLVL System-level data
|
|
*TCPBASE TCP/IP (base)
|
|
*TCPIFC TCP/IP (interface)
|
|
*USRTNS User-defined transaction data
|
|
</pre>
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTPFRDTA.INTERVAL"></a>
|
|
<h3>Time interval (in minutes) (INTERVAL)</h3>
|
|
<p>Specifies the time interval (in minutes) between successive entries in the database file(s). Within the database, these collection intervals will be identified by interval number and interval time.
|
|
</p>
|
|
<p>Interval numbers will begin with 1 and increment with each interval. Interval time will be based on time at the end of the interval synchronized to the clock time (e.g. if INTERVAL(15) is specified, intervals could be generated as 01:00:00, 01:15:00, 01:30:00, and 01:45:00).
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FROMMGTCOL</u></b></dt>
|
|
<dd>The default interval from the management collection object will be used.
|
|
</dd>
|
|
<dt><b><i>number-of-minutes</i></b></dt>
|
|
<dd>Specify an interval value ranging from 0.25 (15 seconds) through 60 minutes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTPFRDTA.FROMTIME"></a>
|
|
<h3>Starting date and time (FROMTIME)</h3>
|
|
<p>Specifies the starting date and time of the performance data in the management collection object which will be used to create the performance database file(s). This time combined with the interval value will determine the date and time for each data base interval.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FROMMGTCOL</u></b></dt>
|
|
<dd>The starting date and time is the date and time that the management collection object was created.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Starting date</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>date</i></b></dt>
|
|
<dd>Specify the starting date for which collection data is generated. The date must be entered in the format specified by the system values QDATFMT and, if separators are used, QDATSEP.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Starting time</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>time</i></b></dt>
|
|
<dd>Specify the starting time on the specified starting date for generating the database intervals.
|
|
<p>If the starting date is specified and the starting time is not, the starting time will default as follows:
|
|
</p>
|
|
<ul>
|
|
<li>If the starting date specifies the first date of the collection, the starting time will be set to the start time of the collection.
|
|
</li>
|
|
<li>If the starting date does not specify the first date of the collection, the starting time will be set to midnight (00:00:00).
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTPFRDTA.TOTIME"></a>
|
|
<h3>Ending date and time (TOTIME)</h3>
|
|
<p>Specifies the ending date and time of the last performance data in the management collection object which will be used to create the performance database file(s).
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FROMMGTCOL</u></b></dt>
|
|
<dd>The date and time of the end of the collection in the management collection object will be the ending date and time for data base generation.
|
|
</dd>
|
|
<dt><b>*ACTIVE</b></dt>
|
|
<dd>The generation of the data base will continue until the currently active collection ends.
|
|
<p>This option causes the data base to be generated concurrently with the active collection. The data base will be generated based on the start time specified for any data currently in the management collection object. Additional data will be processed as it is added to the collection object. This will continue until the current collection ends.
|
|
</p>
|
|
<p>Because this option can result in processing for a very long time, it is recommended that TOTIME(*ACTIVE) be specified only when running CRTPFRDTA in a batch job.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Ending date</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>date</i></b></dt>
|
|
<dd>Specify the ending date for which data from the collection object is used to generate the data base files. The date must be entered in the format specified by the system values QDATFMT and, if separators are used, QDATSEP.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Ending time</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>time</i></b></dt>
|
|
<dd>Specify the time for the specified ending date for which data from the collection object is used to generate the data base files.
|
|
<p>See the description of the <b>Starting time</b> element of the <b>Starting date and time (FROMTIME)</b> parameter for details about how time values can be specified.
|
|
</p>
|
|
<p>If the ending date is specified and the ending time is not, the ending time will default as follows:
|
|
</p>
|
|
<ul>
|
|
<li>If the ending date specifies the last date of the collection, the ending time will be set to the ending time of the collection.
|
|
</li>
|
|
<li>If the ending date does not specify the last date of the collection, the ending time will be set to 23:59:59.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTPFRDTA.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Generating All Data</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTPFRDTA FROMMGTCOL(Q099365001) TOMBR(JAN1) TOLIB(MYLIB)
|
|
</pre>
|
|
</p>
|
|
<p>In this example, the database is generated for all categories contained within the management collection object Q099365001 in library QPFRDATA. The performance database files will be created into library MYLIB and the collection member name will be JAN1.
|
|
</p>
|
|
<p>Data is generated from the start of data collection within this management collection object to the end of that collection. The database interval is the default collection interval that was specified at the time the collection was started.
|
|
</p>
|
|
<p><b>Example 2: Selecting Specific Data</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTPFRDTA FROMMGTCOL(Q099364002) TOMBR(JAN1J) TOLIB(MYLIB)
|
|
CGY(*JOBMI) INTERVAL(15)
|
|
FROMTIME(('01/01/98' '14:00:00'))
|
|
TOTIME(('01/01/98' '16:00:00'))
|
|
</pre>
|
|
</p>
|
|
<p>In this example, only the database file QAPMJOBMI is generated using *JOBMI category information from management collection Q099364002 in library QPFRDATA. The database interval will be 15 minutes even if the data was collected more frequently (for example, the management collection object may contain data collected every 5 minutes). The generated file will contain only data that was collected between 2:00 PM and 4:00 PM even though the collection object may contain data for a larger time interval.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTPFRDTA.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF0A0E</b></dt>
|
|
<dd>CRTPFRDTA ended. No files changed.
|
|
</dd>
|
|
<dt><b>CPF0A1A</b></dt>
|
|
<dd>No active collection.
|
|
</dd>
|
|
<dt><b>CPF0A2B</b></dt>
|
|
<dd>Not able to process management collection object &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9801</b></dt>
|
|
<dd>Object &2 in library &3 not found.
|
|
</dd>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPFRDTA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|