<?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>