Convert Performance Collection (CVTPFRCOL)

The Convert Performance Collection (CVTPFRCOL) command converts performance data from a previous release to the format needed for processing by the current release of IBM Performance Tools for i.

The command first determines the release level at which the data was collected. Then the members of all necessary files are converted. The conversion may be done in the same library where the current data resides. To avoid the risk of destroying the old data if the command ends abnormally, convert the data into a different library (TOLIB), and later, delete the data from the old library (FROMLIB).

If the conversion is done in a different library, the old data remains in the current library (FROMLIB) and the new data resides in the new library (TOLIB). If a new library is specified for the newly converted data, all files are copied to the new library, including those files which do not need to be converted.

Parameters

Keyword Description Choices Notes
FROMLIB From library Name Required, Positional 1
TOLIB To library Name Required, Positional 2
COLTYPE Collection type Character value, *CSFILE, *DWFILE, *JWFILE, *PEXFILE Optional

From library (FROMLIB)

Specifies the library that contains the files to be converted.

This is a required parameter.

name
Specify the name of the library where the files to be converted are located.

To library (TOLIB)

Specifies the library where the converted files will be located.

This is a required parameter.

name
Specify the name of the library where the converted files are to be located.

Collection type (COLTYPE)

Specifies the type of collections to be converted.

*CSFILE
Only the Collection Services file-based collections located in the From library (FROMLIB) are to be converted.
*DWFILE
Only the Disk Watcher file-based collections located in the From library (FROMLIB) are to be converted.
*JWFILE
Only the Job Watcher file-based collections located in the From library (FROMLIB) are to be converted.
*PEXFILE
Only the Performance Explorer file-based collections located in the From library (FROMLIB) are to be converted.
*BCHFILE
Only the Batch Modeler file-based collections located in the From library (FROMLIB) are to be converted.
type
Specify the type of collections to be converted.

Valid values depend on the performance collections supported by the system. You can press F4 while prompting this command parameter to see a list of valid collection type values.

Examples

Example 1: Converting Performance Data Interactively 

CVTPFRCOL   FROMLIB(MIKE)  TOLIB(TERESA)

This command converts the performance data in library MIKE and places it in the library TERESA after conversion is complete. This conversion occurs interactively while the user waits.

Error messages

*ESCAPE Messages

CPF0A0A
Performance data files did not convert.
CPF22F7
Number of authorities must be between 1 and &1.
CPF22FA
Authority value &1 not valid.
CPF22FB
Must specify *EXCLUDE or *AUTL as only authority value.
CPF2817
Copy command ended because of error.
CPF4102
File &2 in library &3 with member &4 not found.
CPF8122
&8 damage on library &4.
CPF9801
Object &2 in library &3 not found.
CPF9802
Not authorized to object &2 in &3.
CPF9803
Cannot allocate object &2 in library &3.
CPF9807
One or more libraries in library list deleted.
CPF9808
Cannot allocate one or more libraries on library list.
CPF9810
Library &1 not found.
CPF9811
Program &1 in library &2 not found.
CPF9812
File &1 in library &2 not found.
CPF9820
Not authorized to use library &1.
CPF9830
Cannot assign library &1.