Convert Pfr Thread Data (CVTPFRTHD)

Where allowed to run: All environments (*ALL)
Threadsafe: No

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.

Top

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.

Top

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.

Top

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.

Top

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.

Top

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.

Top