The Convert Performance Data (CVTPFRDTA) command converts performance data from a previous release to the format needed for processing by the current release of Performance Tools for iSeries(TM).

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
JOBD	Job description	Single values: *USRPRF, *NONE Other values: Qualified object name	Optional
	Qualifier 1: Job description	Name
	Qualifier 2: Library	Name, *LIBL, *CURLIB

Top

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.

Job description (JOBD)

Specifies the job description used to submit jobs for batch processing.

Single values

*USRPRF

The job description specified in the user's user profile is used.

*NONE

A batch job is not submitted. Instead, processing continues interactively while the user waits. The user's work station is not available for other use during this time, which can be significant for long jobs.

Qualifier 1: Job description

name

Specify the name of the job description to be used.

Qualifier 2: Library

*LIBL

All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB

The current library for the job is used to locate the job description. If no current library entry exists in the library list, the QGPL library is used.

name

Specify the name of the library to be searched.

Examples

Example 1: Converting Data Using a Batch Job

CVTPFRDTA   FROMLIB(MIKE)  TOLIB(TERESA)

This command converts the performance data in library MIKE and places it in library TERESA. The conversion is done by a batch job submitted using the job description associated with the user profile of the user running this command.

Example 2: Converting Performance Data Interactively

CVTPFRDTA   FROMLIB(QPFRDATA)  TOLIB(QPFRDATA)  JOBD(*NONE)

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

Error messages

*ESCAPE Messages

CPF0A0B

Performance tools 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.