CVTPFRDTA (Convert Performance Data)

CVTPFRDTA Command syntax diagram

 

Purpose

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 licensed program.

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.

 

Required Parameters

FROMLIB

Specifies the library that contains the files being converted.

TOLIB

Specifies the library where the converted files will be located.

 

Optional Parameters

JOBD

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

*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 workstation is not available for other use during this time, which could be significant for long jobs.

The name of the job description can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

job-description-name: Specify the name of an alternate job description.

Examples for CVTPFRDTA

Example 1: Submitting a Batch Job

CVTPFRDTA  FROMLIB(MIKE)  TOLIB(TERESA)

This command converts the performance data in library MIKE and places it in library TERESA.

Example 2: Submitting a Job 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 for CVTPFRDTA

*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 &1in library &2 not found.

CPF9812

File &1in library &2 not found.

CPF9820

Not authorized to use library &1.

CPF9830

Cannot assign library &1.