CL Command Reference - STRPFRCOL
CL Command List > STRPFRCOL Reference
Description:
The Start Performance Collection (STRPFRCOL) command starts the system-level collection of performance data by Collection Services. The properties of the system-level collection are controlled by the Collection Services configuration, which can be changed using the Configure Performance Collection (CFGPFRCOL) command. The data included in the system-level collection is determined by the value specified on the Collection profile parameter.
Performance data collection is conducted by the Collection Services server job (QYPSPFRCOL). If this job is not active, it will be started as a result of this command. If the job is active, any change to the collection profile will take effect immediately and the collection will continue uninterrupted.
QYPSPFRCOL creates a management collection object (*MGTCOL) to store performance data. Data collected will include both the system-level collection profile categories as well as data collected on behalf of client applications (for example, iSeries Navigator monitors or Performance Collector APIs). All data is stored in the current management collection object. This data may be processed using the Create Performance Data (CRTPFRDTA) command to generate the performance database files.
Cycling the performance collection will cause the Collection Services server job to create a new management collection object prior to implementing the specified Collection profile. Note: cycling may result in the loss of one interval of data and will also impact any client applications that are using Collection Services.
Examples:
Example 1: Starting the Performance Collection
STRPFRCOL
This command will cause the Collection Services server job (QYPSPFRCOL) to start the system-level collection of performance data using the currently configured default collection profile.
Example 2: Starting with Collection Profile and Cycle Collection
STRPFRCOL COLPRF(*MINIMUM) CYCCOL(*YES)
This command will cause the Collection Services server job (QYPSPFRCOL) to cycle and begin collecting performance data in a new management collection object (*MGTCOL) using the *MINIMUM collection profile. Note: this command will also change the configured default collection profile to *MINIMUM.