Print Job Trace (PRTJOBTRC)

The Print Job Trace (PRTJOBTRC) command produces performance-oriented reports that are used to analyze job trace data collected earlier with the Start Job Trace (STRJOBTRC) and End Job Trace (ENDJOBTRC) commands.

Parameters

Keyword	Description	Choices	Notes
MBR	Data base file member	Name, QAJOBTRC	Optional, Positional 1
LIB	Data base file library	Name, QPFRDATA	Optional, Positional 2
RPTTYPE	Report type	BOTH, DETAIL, *SUMMARY	Optional, Positional 3
TITLE	Report title	Character value, *BLANK	Optional, Positional 4
STRSEQ	Starting sequence number	1-999999, *FIRST	Optional
ENDSEQ	Ending sequence number	Decimal number, *LAST	Optional
ENDTNS	Transaction ending program	Name, QT3REQIO, *BATCH	Optional
STRTNS	Transaction starting program	Name, QWSGET	Optional
JOB	Job name	Name, PRTJOBTRC, *MBR	Optional
JOBD	Job description	Single values: NONE Other values: Qualified object name*	Optional
	Qualifier 1: Job description	Name, QPFRJOBD
	Qualifier 2: Library	Name, LIBL, CURLIB

Top

Data base file member (MBR)

Specifies the member in file QAPTTRCJ in which the trace data is saved by the End Job Trace (ENDJOBTRC) command.

QAJOBTRC: The standard member name, QAJOBTRC, is used.
member-name: Specify the name of the member in which the data is saved.

Data base file library (LIB)

Specifies the library in which the job trace data is saved by the End Job Trace (ENDJOBTRC) command.

QPFRDATA: The trace data is saved in the IBM-supplied performance data library, QPFRDATA.
library-name: Specify the name of the library in which the trace data is saved.

Report type (RPTTYPE)

Specifies the type of report(s) to produce.

Note: If summary reports are selected (by specifying *BOTH or *SUMMARY for this parameter), the summary reports contain information only when transaction ending program and transaction starting program pairs are found in the collected data.

*BOTH: Both the detail and summary reports are produced (three reports total).
*DETAIL: A report is produced detailing the individual job trace records. The output is directed to the printer file QPPTTRCD. Each page heading includes the text 'Job Trace Information'.
*SUMMARY: Two reports are produced summarizing the job trace data by transaction. One report shows primarily physical disk activity; its printer file is QPPTTRC1, and its page heading includes the text 'Trace Analysis Summary'. The other report concentrates on higher level activities such as database I/O and inter-program transfers of control; its printer file is QPPTTRC2, and its page heading includes the text 'Trace Analysis I/O Summary'.

Report title (TITLE)

Specifies a title that is printed on the page heading of each report.

*BLANK: No title is specified.
'report-title': Specify title of up to 50 characters enclosed in apostrophes. This may be used, for example, to distinguish between reports on different sets of trace data or different sections of the same data.

Starting sequence number (STRSEQ)

Specifies the sequence number of the first job trace record that is included in any reports. No records preceding this one are listed in the detail report or counted in either summary report.

*FIRST: Trace records starting from the first job trace record (sequence number 1) are included.
sequence-number: Specify the sequence of the first trace record that is included. An appropriate value can be determined by previewing reports produced from all the job trace data. This can be used to bracket a particular set of transactions on which to report.

Ending sequence number (ENDSEQ)

Specifies the sequence number of the last job trace record that is included in any reports. No records following this one are listed in the detail report or counted in either summary report.

*LAST: Trace records through the last trace record are included.
sequence-number: Specify the sequence number of the last trace record that is included. An appropriate value can be chosen through a preview process so as to bracket a particular set of transactions.

Transaction ending program (ENDTNS)

Specifies the program that signifies the end of a transaction. A program must also be specified on the Transaction starting program prompt (STRTNS parameter).

QT3REQIO: The work station I/O program, QT3REQIO, is used. This value is used to break the trace data into work station transactions.
program-name: Specify the name of the program that ends a transaction. This allows reporting on non-work station transactions, such as communications lines.

Transaction starting program (STRTNS)

Specifies the program that signifies the start of a transaction. A program must also be specified on the Transaction ending program prompt (ENDTNS parameter).

QWSGET: The work station input program, QWSGET, is used. This value is used to break the trace data into work station transactions.
program-name: Specify the name of the program that starts a transaction.

Job name (JOB)

Specifies the job name to be used if submitting the job for batch processing.

Any value for this parameter is ignored if *NONE is specified for the Job description prompt (JOBD parameter).

Note: If *NONE is specified for the Job description prompt (JOBD parameter), job processing is performed interactively.

The possible job-name values are:

PRTJOBTRC: The command name is used for the job name.
*MBR: The name selected for the performance data member in the Member prompt (MBR parameter) is used.
job-name: Specify the name to be used for any and all batch jobs.

Batch job description (JOBD)

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

The possible job description values are:

QPFRJOBD: The IBM-supplied job description, QPFRJOBD, is used.
job-description-name: Specify the name of an alternate job description.
*NONE: A batch job is not submitted; 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 possible library values are:

*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 used to locate the job description. If no current library entry exists in the library list, QGPL is used.
library-name: Specify the library in which the job description is located.

Examples

PRTJOBTRC   LIB(MYLIB)  RPTTYPE(*DETAIL)

This command produces a detail report using data saved in member QAJOBTRC of file QAPTTRCJ in library MYLIB.