Configure Perf Collection (CFGPFRCOL)

Parameters

Keyword	Description	Choices	Notes
INTERVAL	Default interval	*SAME, 0.25, 0.5, 1.0, 5.0, 15.0, 30.0, 60.0	Optional, Positional 1
LIB	Collection library	Name, *SAME	Optional
DFTCOLPRF	Default collection profile	SAME, MINIMUM, STANDARD, STANDARDP, ENHCPCPLN, CUSTOM	Optional
CYCTIME	Cycle time	Time, *SAME	Optional
CYCITV	Cycle interval	1-24, *SAME	Optional
RETPERIOD	Collection retention period	Single values: SAME, PERM Other values: Element list	Optional
	Element 1: Number of units	1-720
	Element 2: Unit of time	HOURS, DAYS
CRTDBF	Create database files	SAME, YES, *NO	Optional
CHGPMLIB	Change PM iSeries library	NO, YES	Optional

Top

Default interval (INTERVAL)

The default collection interval (in minutes). This value is used by most data categories as the collection sample interval. Although some I/O categories are set up to use a specific interval time, this value will determine the collection sample interval for most data. This change will take effect immediately.

*SAME: The value does not change. If the configured value has never been modified, the interval will be 15 minutes.
0.25: The default collection interval will be 15 seconds.
0.5: The default collection interval will be 30 seconds.
1.0: The default collection interval will be 1 minute.
5.0: The default collection interval will be 5 minutes.
15.0: The default collection interval will be 15 minutes.
30.0: The default collection interval will be 30 minutes.
60.0: The default collection interval will be 60 minutes.

Default collection profile (DFTCOLPRF)

Specifies the default collection profile. This determines which categories will be included in the system-level collection. This change will take effect the next time a collection object is created.

*SAME: The value does not change. If the configured value has never been modified, the default collection profile will be *STANDARDP.
*MINIMUM: The minimum data collection recommended. Includes the following categories: *SYSBUS, *POOL, *HDWCFG, *SYSCPU, *SYSLVL, *JOBMI, *JOBOS, *DISK, and *IOPBASE.
*STANDARD: The standard profile includes all categories which are typically needed by the Performance Tools for iSeries, with the exception of communications data. It includes all categories in the *MINIMUM profile, as well as the following categories: *POOLTUNE, *SUBSYSTEM, *SNADS, *LCLRSP, *APPN, *SNA, *TCPBASE, *USRTNS and *LPAR. The category *DOMINO will be included if the product Domino for iSeries has been installed on the system. The category *HTTP will be included if the product IBM HTTP Server for iSeries (powered by Apache) has been installed on the system.
*STANDARDP: The standard plus profile includes all categories which are typically needed by the Performance Tools for iSeries, including communications data. It includes all categories in the *STANDARD profile, as well as the following categories: *IPCS, *CMNBASE, *CMNSTN, *CMNSAP, *TCPIFC, and *DPS.
*ENHCPCPLN: The enhanced capacity planner profile includes all categories in the *STANDARDP profile, with the addition *INTPEX.
*CUSTOM: The custom profile includes categories as defined by the user. This profile must be defined using the Collection Services function in iSeries Navigator.

Cycle time (CYCTIME)

The base time at which the Collection Services server job (QYPSPFRCOL) will end the current collection and begin collecting data in a new management collection object (*MGTCOL). This change will take effect immediately.

*SAME: The value does not change. If the configured value has never been modified, the cycle time will be midnight.
time: Specify the time of day at which the collector will cycle. Although the CL command allows you to enter a time value that contains seconds, Collection Services supports only the hour and minute to cycle. Any value entered for seconds is ignored.

Collection retention period (RETPERIOD)

Specifies how long the management collection object (*MGTCOL) should be retained on the system. After the retention period has expired, the object will be automatically deleted by the Collection Services server job (QYPSPFRCOL). Expired collections are removed from the system each time a collection starts or cycles. This change will take effect immediately and will apply to the current and future collection objects.

Single values

*SAME: The value does not change. If the configured value has never been modified, the retention period will be 24 hours.
*PERM: The object will not be automatically deleted.

Element 1: Number of units

retention-time: Specify how long the management collection object should be retained in hours or days. The collection object may be retained for up to 30 days.

Element 2: Unit of time

Specify whether the retention-time value specified for the Number of units element should be treated as a number of hours or a number of days.

*HOURS: The retention period is specified in hours. The valid time period range is 1 through 720.
*DAYS: The retention period is specified in days. The valid time period range is 1 through 30.

Create database files (CRTDBF)

This option will submit the Create Performance Data (CRTPFRDTA) job. This job will create the performance database files and process the data in the current management collection object as it is collected. The CRTPFRDTA job will end when the Collection Services server job (QYPSPFRCOL) ends or cycles. If this option is set to *YES, a new CRTPFRDTA job will be submitted for every management collection object (*MGTCOL) created. This change will take effect the next time a collection object is created.

*SAME: The value does not change. If the configured value has never been modified, this option will be *NO.
*YES: The CRTPFRDTA job is submitted.
*NO: The CRTPFRDTA job is not submitted.

Change PM iSeries library (CHGPMLIB)

This option will change the PM iSeries library to match the library used by Collection Services.

PM iSeries has its own configuration. When PM iSeries is running it will change the Collection Services configuration (on an hourly basis) so that the data it requires is collected and stored in the PM iSeries configured library. If you specify *YES, the PM iSeries collection library will be changed to the Collection Services collection library. If the Collection Services server job is running when this option is specified, the collection will be cycled so that the change to both libraries will take effect simultaneously.

If the PM iSeries library is changed, you should be aware of the following: PM iSeries will not be able to process any data which was collected in the previous library. In addition, PM iSeries will automatically remove data in the new library based on the PM iSeries setting Performance data purge days. To change the number of days performance data is retained, type GO PM iSeries and select the Work with PM iSeries Customization option.

*NO: The PM iSeries library name will not be changed.
*YES: The PM iSeries library name will be changed to match the library used by Collection Services.

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.