CL Command Reference - CFGPFRCOL
CL Command List > CFGPFRCOL Reference
Description:
The Configure Performance Collection (CFGPFRCOL) command changes the Collection Services properties. These properties define certain collection attributes and determine how Collection Services will manage data collection. Some attributes changed with this command will take effect immediately, while others will take effect the next time a collection object is created. See the parameter help to determine how each attribute will be handled. The Collection Services server job (QYPSPFRCOL) can be started or cycled by using the Start Performance Collection (STRPFRCOL) command.
Examples:
Example 1: Configuring Default Interval and Collection Library
CFGPFRCOL INTERVAL(5) LIB(QMPGDATA)
This command will cause the default interval at which most sample data is collected to be changed immediately to 5 minutes. In addition, the library where data is collected will change to QMPGDATA the next time a management collection object (*MGTCOL) is created.
Example 2: Configuring Cycle Time and Cycle Interval
CFGPFRCOL CYCTIME(030000) CYCITV(6)
This command will change the cycle time and cycle interval of the collection. The base cycle time will be 3:00 a.m. and the collection will cycle every six hours from the base time. New management collection objects (*MGTCOL) will be created at the following times: 3:00, 9:00, 15:00, 21:00, 3:00, 9:00, and so on.
Example 3: Configuring Retention Period
CFGPFRCOL RETPERIOD(25 *DAYS)
This command will cause the current and future collection objects to be retained on the system for 25 days before being automatically deleted by the Collection Services server job (QYPSPFRCOL).
Example 4: Configuring Default Collection Profile and Create Database Files
CFGPFRCOL DFTCOLPRF(*STANDARD) CRTDBF(*YES)
This command causes changes that will take effect the next time a management collection object (*MGTCOL) is created. At that time, the collection profile will change to *STANDARD and the Create Performance Data (CRTPFRDTA) job will be submitted.
Example 5: Changing the PM iSeries Library
CFGPFRCOL LIB(QPFRDATA) CHGPMLIB(*YES)
This command will change both the Collection Services collection library and the PM iSeries configured library to QPFRDATA. If the Collection Services server job is running, it will be cycled and the change will take effect immediately.