115 lines
7.6 KiB
HTML
115 lines
7.6 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow" />
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<meta name="DC.Type" content="task" />
|
|
<meta name="DC.Title" content="Gathering performance data with Collection Services" />
|
|
<meta name="abstract" content="If you are not running Collection Services, or your collection objects are not current, start Collection Services in any of the following ways:" />
|
|
<meta name="description" content="If you are not running Collection Services, or your collection objects are not current, start Collection Services in any of the following ways:" />
|
|
<meta name="DC.Relation" scheme="URI" content="gatherperfdata.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2004, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2004, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="gatheringperformancedatawithcollectionservices" />
|
|
<meta name="DC.Language" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>Gathering performance data with Collection Services</title>
|
|
</head>
|
|
<body id="gatheringperformancedatawithcollectionservices"><a name="gatheringperformancedatawithcollectionservices"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Gathering performance data with Collection Services</h1>
|
|
<div><p>If you are not running Collection Services, or your collection
|
|
objects are not current, start Collection Services in any of the following
|
|
ways:</p>
|
|
<div class="p"></div>
|
|
<div class="section"><ul><li>Use the <a href="../rzahx/rzahxcollectdatacs.htm">Collection
|
|
Services</a> function that is available in <span class="keyword">iSeries™ Navigator</span>. </li>
|
|
<li>Use either the <a href="../apis/qypsstrc.htm">Start
|
|
Collector</a> (QYPSSTRC) API or the Start Performance Collection (STRPFRCOL)
|
|
command. If you do not use the Management Central function in <span class="keyword">iSeries Navigator</span>,
|
|
you can manage your collections with either of the following methodss: <ul><li><a href="../apis/perfmgmt.htm">Performance
|
|
Management APIs</a> .
|
|
These APIs start, end, and cycle collections, and change and retrieve system
|
|
parameters for the data collected.</li>
|
|
<li>Performance collection commands: STRPFRCOL, End Performance Collection
|
|
(ENDPFRCOL), Configure Performance Collection (CFGPFRCOL), and Check Performance
|
|
Collection (CHKPRFCOL). These commands start, end, and cycle collections for
|
|
the data collected.</li>
|
|
</ul>
|
|
</li>
|
|
<li>If you have the Performance Tools licensed program (PT1) installed, use
|
|
Option 2 from the Performance Tools main menu. Refer to <a href="../books/sc415340.pdf" target="_blank">Performance Tools for iSeries</a> <img src="wbpdf.gif" alt="Link to PDF" /> for additional
|
|
information on collecting performance data with this option.</li>
|
|
<li>Activate <a href="../rzahx/rzahxplangrow1pm1.htm">IBM
|
|
Performance Management for eServer <span class="keyword">iSeries</span></a>,
|
|
which automates the start of Collection Services and then creates the database
|
|
files during collection.</li>
|
|
</ul>
|
|
<p>Ensure that Collection Services has been configured to collect the
|
|
data you require, and that it runs long enough to accurately represent your
|
|
operating environment.</p>
|
|
<p>The following example uses the <a href="../apis/perfmgmt_colsvc1.htm">Collector APIs</a>.</p>
|
|
</div>
|
|
<ol><li class="stepexpand"><span>Run Collection Services for at least one or two days, and make
|
|
sure that peak and off-peak workloads are represented. Type this command: </span> <pre>CALL PGM(QYPSSTRC) PARM('*PFR ' '*STANDARDP' X'00000000')</pre>
|
|
<p>This
|
|
command starts Collection Services and uses the <strong>Standard plus protocol</strong> for
|
|
the collection profile. Once you start Collection Services with this command,
|
|
it will collect performance data and store it in the collection object until
|
|
you either explicitly stop it or restart the system. (If collection was run
|
|
for more than one day, more than one collection object will be produced.)
|
|
This profile collects all the data categories typically needed by the tools
|
|
in Performance Tools for iSeries, including communications protocol data.
|
|
The default configuration also starts a batch job CRTPFRDTA, which creates
|
|
the performance database files. </p>
|
|
</li>
|
|
<li class="stepexpand"><span>Collection Services stores the data in an object type of *MGTCOL. </span> <div class="p">You can convert this object into performance database files for
|
|
later analysis. To retain the object for future use, you can save the objects
|
|
to tape or to a save file (SAVF). Collection Services can delete collection
|
|
objects from the server at any time after the retention period has expired.
|
|
The default retention period is 24 hours. If you do not want Collection Services
|
|
to delete your collection objects for you, change your retention period to
|
|
permanent (set a retention period of *PERM) as shown in the example that follows.
|
|
<div class="note"><span class="notetitle">Note:</span> The following command example shows the shipped default values with
|
|
the exception of the retention period value. A retention period of *PERM requires
|
|
a value of 0. Furthermore, you must make this change before or during the
|
|
data collection. The change does not affect any collection objects that are
|
|
already cycled.</div>
|
|
</div>
|
|
<p>To change the retention period by using the Change
|
|
Collection Services Attributes API, type the following command: </p>
|
|
<div class="note"><span class="notetitle">Note:</span> By using the following code example, you agree to the terms of
|
|
the <a href="codedisclaimer.htm">Code license and disclaimer information</a>.</div>
|
|
<pre>CALL PGM(QYPSCSCA) PARM('*PFR ' /* collection */
|
|
X'00000384' /* interval 900 sec */
|
|
'QPFRDATA ' /* library */
|
|
X'00000000' /* retention period is permanent */
|
|
X'00000000' /* cycle time 00:00:00 */
|
|
X'00000018' /* cycle interval 24Hrs */
|
|
X'00000001' /* start CRTPFRDTA */
|
|
'*STANDARDP' /* default profile */
|
|
X'00000000') /* return code */
|
|
</pre>
|
|
</li>
|
|
<li class="stepexpand"><span>If you want to explicitly stop the collector after the desired
|
|
data is obtained, type this command: </span> <pre>CALL PGM(QYPSENDC) PARM('*PFR ' X'00000000')</pre>
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="gatherperfdata.htm" title="Establish system benchmarks before you install a new version of the operating system or make a major system configuration change such as adding a new software application.">Gathering performance data for benchmark</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |