| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Print Job Trace Report (PRTTRCRPT) command generates a report showing resources utilized, exceptions, and state transitions for batch jobs traced through time.
The report is based on the trace data collected by the Start Performance Trace (STRPFRTRC) command. This report runs against the specified member that was created when the Print Transaction Report (PRTTNSRPT) command was run with the *FILE option. The member resides in the QTRJOBT file of the QPFRDATA library.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| MBR | Member | Name | Required, Positional 1 |
| LIB | Library | Name, QPFRDATA | Optional, Positional 2 |
| TITLE | Title | Character value, *MBR | Optional, Positional 3 |
| PERIOD | Time period for report | Element list | Optional |
| Element 1: | Element list | ||
| Element 1: Starting time | Time, *FIRST | ||
| Element 2: Starting date | Date, *FIRST | ||
| Element 2: | Element list | ||
| Element 1: Ending time | Time, *LAST | ||
| Element 2: Ending date | Date, *LAST | ||
| JOB | Job name | Name, PRTTRCRPT, *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 |
Specifies the performance data member used. This name should correspond to the member name specified when the Print Transaction Report (PRTTNSRPT) command was run with *FILE option.
This is a required parameter.
| Top |
Specifies the library where the performance data is located.
| Top |
Specifies the title for the report that is created.
| Top |
Specifies the period of time on which to report. The parameter consists of two lists of two elements each.
The symbol *N can be used to maintain the position in the parameter value sequence in place of an element that precedes the values that are specified. For example, PERIOD(*N (*N 091290)) specifies the ending date and uses the defaults for the other values.
Element 1: Starting time and date
Element 1: Starting time
The time can be specified with or without a time separator:
The time is in 24-hour format (13:00 is one p.m.); hours, minutes, and seconds values must be 2-digits in length, meaning zeros must be included.
Element 2: Starting date
Element 2: Ending time and date
Element 1: Ending time
Element 2: Ending date
| Top |
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 (JOBD) parameter.
Note: If JOBD(*NONE) is specified, job processing is performed interactively.
| Top |
Specifies the job description used to submit the job for batch processing.
Single values
Qualifier 1: Job description
Qualifier 2: Library
| Top |
Example 1: Printing a Job Trace Summary Report
PRTTRCRPT MBR(JUNE01)
This command submits a batch job that generates a Job Trace Summary report using the performance data found in the member JUNE01 of file QTRJOBT located in the default library QPFRDATA. The report covers the entire collection period, and the title of the report is set to the name of the database file member.
Example 2: Specifying a Report Time Period
PRTTRCRPT MBR(NOV15)
PERIOD(('0800:00' '11/15/99')
('2359:59' '11/15/99'))
TITLE('Job Trace Reports for November 15')
This command submits a batch job that generates a Job Trace Summary report. The performance data comes from member NOV15 of file QTRJOBT of the default library QPFRDATA. The report covers the time period 8:00 in the morning to midnight of one day.
Note: The format for the date and time is determined by the system values QDATFMT and, because separators are used in this example, QDATSEP.
| Top |
| Top |