The Convert Performance Thread (CVTPFRTHD) command converts job performance data records. It supports data collected by the STRPFRMON (Start Performance Monitor) command or data generated by the CRTPFRDTA (Create Performance Data) command.

The specified member (MBR parameter) of file QAPMJOBS or QAPMJOBL contains records with thread-level performance data. You can use CVTPFRTHD to convert this data and write the resulting records to a member by the same name (MBR parameter) in file QAPMTJOB. The output file member will contain records with job-level performance data which are a total of the performance information for all threads running within the job.

The input file (QAPMJOBS or QAPMJOBL) must exist in the library specified on the LIB parameter. If file QAPMTJOB does not exist in the specified library (LIB parameter), it will be created automatically. A file member by the name specified (MBR parameter) will be automatically added to file QAPMTJOB if it did not already exist.

Parameters

Keyword	Description	Choices	Notes
MBR	Member	Name	Required, Positional 1
LIB	Library	Name, QPFRDATA	Optional
REPLACE	Replace	*YES, *NO	Optional

Top

Member (MBR)

Specifies the member of file QAPMJOBS or file QAPMJOBL that contains the collections to be processed. This member will be created, if it does not already exist, or replaced in QAPMTJOB file.

name

Specify the name of the member containing thread-level performance data.

Library (LIB)

Specifies the library where the input file resides, and where the QAPMTJOB file either resides or will be created.

QPFRDATA

IBM-supplied performance data library QPFRDATA is to be used to locate the input database file.

name

Specify the name of the library where the input database file is located.

Replace (REPLACE)

Specifies whether the specified member in file QAPMTJOB will be replaced.

*YES

If the member did not exist before, it is created. If the member already exists, the data contained in it is replaced.

*NO

If the member did not exist before, it is created. If the member already exists, the data contained in it is not replaced and an error message is signalled.

Examples

CVTPFRTHD   MBR(MYDATA)

This command converts performance data records. Member MYDATA in file QAPMJOBL or file QAPMJOBS in library QPFRDATA contains the collections to be processed.

Error messages

*ESCAPE Messages

CPF0A83

Performance thread data not converted.

CPF0A84

Member already exists.

CPF0A85

User profile &1 is not authorized to library &2.

CPF2110

Library &1 not found.

CPF2817

Copy command ended because of error.

CPF5030

Partial damage on member &4.

CPF9810

Library &1 not found.

CPF9812

File &1 in library &2 not found.

CPF9845

Error occurred while opening file &1.

CPF9846

Error while processing file &1 in library &2.