PRTTRCRPT (Print Trace Report)

Note: To use this command, have the 5722-PT1 (Performance Tools for iSeries) licensed program installed.

PRTTRCRPT Command syntax diagram

 

Purpose

The Print Trace Report (PRTTRCRPT) command produces a report that shows resources utilized, exceptions, and state transitions for batch jobs traced through time. This 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. This member resides in the QTRJOBT file of the QPFRDATA library.

 

Required Parameters

MBR
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 the *FILE option.

 

Optional Parameters

LIB
Specifies the library where the performance data is located.

QPFRDATA: The performance data files are located in the IBM-supplied performance data library, QPFRDATA.

library-name: Specify the name of the library where the performance database files are located.

TITLE
Specifies the title for the job trace report that is created.

*MBR: The member name specified in the MBR parameter is used for the report title.

'report-title': Specifies the title for the job trace report. The title can be up to 50 characters, enclosed in apostrophes.

PERIOD
Specifies the period of time on which to report. The value consists of two lists of two elements each:

PERIOD((start-time start-date)
  (end-time end-date))

*N may 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

One of the following values is used to specify the starting time. Data collected prior to this time on the starting date is not included in the report.

*FIRST: Data records starting from the beginning of the day (00:00:00) are included.

start-time: Specify the time of the first data record to include in the report. The time is specified in 24-hour format with or without a time separator as follows:

  • With a time separator, specify a string of 5 or 8 digits, where the time separator for the job separates the hours, minutes, and seconds. If you issue this command from the command line, the string must be enclosed in apoltrophes. If a time separator other than the separator specified for your job is used, this command fails.

  • Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Valid values for hh range from 00 through 23. Valid values for mm and ss range from 00 through 59.

Element 2: Starting Date

One of the following values is used to specify the starting date. Data collected prior to the starting time on this date is not included in the report.

*FIRST: Data records starting from the first day of the collection period are included.

start-date: Specify the date of the first data record to include in the report. The date must be entered in the format specified by QDATFMT and, if separators are used, QDATSEP. For instance, the system might have a date format of 'mm/dd/yy'. The month (mm), day (dd), and year (yy) are all required 1- or 2-digit values. The slashes (/) are optional if all six digits are specified. If the slashes are omitted, or if the value is entered from the prompt display, the apostrophes (') are not required.

Element 3: Ending Time

One of the following values is used to specify the ending time. Data collected after this time on the ending date is not included in the report.

*LAST: Data records through the end of the day (23:59:59) are included in the report.

end-time: Specify the time of the last data record to include in the report. See start-time in this parameter for details on how the time must be specified.

Element 4: Ending Date One of the following values is used to specify the ending date. Data collected after the ending time in this date is not included in the report.

*LAST: Data records through last day of the collection period included in the report.

end-date: Specify the date of the last data record to include in the report. Use the same date format used for the starting date.

JOB
Specifies the job name used if the job is submitted for batch processing.

Note: If *NONE is specified on the JOBD parameter, this parameter is ignored; job processing is performed interactively.

PRTTRCRPT: The command name is used for the job name.

*MBR: The name selected for the performance data member on the MBR parameter is used.

job-name: Specify the name used for batch jobs.

JOBD
Specifies the job description used by the jobs that submit the report for batch processing.

The name of the job description can be qualified by one of the following library values:

  • *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 searched. If no library is specified as the current library for the job, the QGPL library is used.

  • library-name: Specify the name of the library to be searched.



QPFRJOBD: The IBM-supplied Performance Tools job description, QPFRJOBD, is used.

job-description-name: Specify the name of an alternative job description.

*NONE: A batch job is not submitted. Processing continues interactively while the user waits. The user's work station is not available for other use during this time.

Examples for PRTTRCRPT

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.

Error messages for PRTTRCRPT

*ESCAPE Messages

PFR5515
Cannot access trace data.