Convert Performance Data (CVTPFRDTA)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Convert Performance Data (CVTPFRDTA) 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 old data remains in the current library (FROMLIB) and the new data resides in the new library (TOLIB). All files are copied to the new library, including those files which do not need to be converted.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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(MIKE) TOLIB(TERESA) JOBD(*NONE)
This command converts the performance data in library MIKE and places it in library TERESA. The conversion occurs interactively while the user waits.
| Top |
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.
- CPF2365
- FROMLIB and TOLIB parameters cannot specify the same library.
- 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.
| Top |