Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Print Job Report (PRTJOBRPT) command produces a job-oriented report from the performance data collected by Collection Services from the Operations Navigator interface. The report, which is written to the printer file QPPTITVJ, shows job information by interval. Jobs may be included or excluded from the report based on a variety of job details and interval times.
Top |
Keyword | Description | Choices | Notes |
---|---|---|---|
MBR | Member | Name | Required, Positional 1 |
TITLE | Report title | Character value, *MBRTXT, *BLANK | Optional, Positional 3 |
PERIOD | Time period for report | Element list | Optional |
Element 1: | Element list | ||
Element 1: Starting time | Time, *FIRST, *SELECT | ||
Element 2: Starting date | Date, *FIRST | ||
Element 2: | Element list | ||
Element 1: Ending time | Time, *LAST | ||
Element 2: Ending date | Date, *LAST | ||
LIB | Library | Name, QPFRDATA | Optional, Positional 2 |
DETAIL | Report detail | *JOB, *THREAD | Optional |
SLTJOB | Select jobs | Single values: *ALL Other values (up to 50 repetitions): Element list |
Optional |
Element 1: Job name | Qualified job name | ||
Qualifier 1: Job name | Generic name, name | ||
Qualifier 2: User | Generic name, name | ||
Qualifier 3: Number | 000000-999999 | ||
Element 2: | Element list | ||
Element 1: Thread | Character value, *ALL | ||
OMTJOB | Omit jobs | Single values: *NONE Other values (up to 50 repetitions): Element list |
Optional |
Element 1: Job name | Qualified job name | ||
Qualifier 1: Job name | Generic name, name | ||
Qualifier 2: User | Generic name, name | ||
Qualifier 3: Number | 000000-999999 | ||
Element 2: | Element list | ||
Element 1: Thread | Character value, *ALL | ||
SLTUSRID | Select users | Single values: *ALL Other values (up to 50 repetitions): Generic name, name |
Optional |
OMTUSRID | Omit users | Single values: *NONE Other values (up to 50 repetitions): Generic name, name |
Optional |
SLTPOOLS | Select pools | Single values: *ALL Other values (up to 64 repetitions): 1-64 |
Optional |
OMTPOOLS | Omit pools | Single values: *NONE Other values (up to 64 repetitions): 1-64 |
Optional |
SLTSBS | Select subsystems | Single values: *ALL Other values (up to 50 repetitions): Name |
Optional |
OMTSBS | Omit subsystems | Single values: *NONE Other values (up to 50 repetitions): Name |
Optional |
SLTLINE | Select communications lines | Single values: *ALL Other values (up to 50 repetitions): Name |
Optional |
OMTLINE | Omit communications lines | Single values: *NONE Other values (up to 50 repetitions): Name |
Optional |
SLTCTL | Select control units | Single values: *ALL Other values (up to 50 repetitions): Name |
Optional |
OMTCTL | Omit control units | Single values: *NONE Other values (up to 50 repetitions): Name |
Optional |
SLTFCNARA | Select functional areas | Single values: *ALL Other values (up to 50 repetitions): Character value |
Optional |
OMTFCNARA | Omit functional areas | Single values: *NONE Other values (up to 50 repetitions): Character value |
Optional |
OMTSYSTSK | Omit system tasks | *YES, *NO | Optional |
JOB | Job name | Name, PRTJOBRPT, *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 on the TOMBR parameter of the Create Performance Data (CRTPFRDTA) command.
This is a required parameter.
Top |
Specifies the title for the report that is created.
Top |
Specifies the period of time on which to report. The parameter consists of four elements: a starting time and date, and an ending time and date. Data collected prior to the starting time on the starting date and after the ending time on the ending date is not included in the report.
The symbol *N can be used to designate the default value for any of the four elements.
The possible starting time values are:
The time is specified in 24-hour format with or without a time separator:
All time and date entries must be 2-digits in length, meaning zeros must be included.
The possible starting date values are:
The possible ending time values are:
The possible ending date values are:
Top |
Specifies the library where the performance data is located.
Top |
Specifies whether you want the report to provide detailed job information at the job level or the thread level.
Top |
Specifies a list of up to 50 jobs to be included in the report. Only specified jobs are included in the report.
Individual jobs are identified by a "job identifier." A job identifier is either the special value *ALL or a qualified name that consists of up to three elements: a job number, a user name, and a job name. Job identifiers are written in the form, job-number/user-name/job-name, but all three elements do not have to be specified. The symbol *N can be used as a placeholder for up to two of the elements of the job identifier.
Note: This parameter and the Omit jobs prompt (OMTJOB parameter) are mutually exclusive.
You can enter multiple values for this parameter.
Element 1: Job name
Note: A generic name is a character string that contains one or more characters followed by an asterisk(*), for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic name, the system assumes it to be the complete object name.
Element 2: Thread
Top |
Specifies a list of up to 50 jobs to be omitted from the report.
Individual jobs are identified by a "job identifier." A job identifier is either the special value *NONE or a qualified name that consists of up to three elements: a job number, a user name, and a job name. Job identifiers are written in the form, job-number/user-name/job-name, but all three elements do not have to be specified. The symbol *N can be used as a placeholder for up to two of the elements of the job identifier.
Note: This parameter and the Select jobs prompt (SLTJOB parameter) are mutually exclusive.
You can enter multiple values for this parameter.
Element 1: Job name
Note: A generic name is a character string that contains one or more characters followed by an asterisk(*), for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic name, the system assumes it to be the complete object name.
Element 2: Thread
Top |
Specifies a list of up to 50 user names to be included in the report. Only jobs with one of the specified user names are included in the report.
Note: This parameter and the Omit users prompt (OMTUSRID parameter) are mutually exclusive.
You can enter multiple values for this parameter.
Note: A generic name is a character string that contains one or more characters followed by an asterisk(*), for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic name, the system assumes it to be the complete object name.
Top |
Specifies a list of up to 50 user names to be omitted from the report.
Note: This parameter and the Select users prompt (SLTUSRID parameter) are mutually exclusive.
You can enter multiple values for this parameter.
Note: A generic name is a character string that contains one or more characters followed by an asterisk(*), for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic name, the system assumes it to be the complete object name.
Top |
Specifies a list of up to 64 pools to be included in the report.
Note: This parameter and the Omit pools prompt (OMTPOOLS parameter) are mutually exclusive.
You can enter multiple values for this parameter.
Top |
Specifies a list of up to 64 pools to omit. Jobs that ran in any of the specified pools are excluded from the report.
Note: This parameter and the Select pools prompt (SLTPOOLS parameter) are mutually exclusive.
You can enter multiple values for this parameter.
Top |
Specifies a list of up 50 subsystems to select. Only jobs that ran in one of the specified subsystems are included in the report.
Note: This parameter and the Omit subsystems prompt (OMTSBS parameter) are mutually exclusive.
You can enter multiple values for this parameter.
Top |
Specifies a list of up to 50 subsystems to omit. Jobs that ran in any of the specified subsystems are excluded from the report.
Note: This parameter and the Select subsystems prompt (SLTSBS parameter) are mutually exclusive.
You can enter multiple values for this parameter.
Top |
Specifies a list of up to 50 communications lines to select. Only jobs that use a remote device connected through one of the specified communications lines are included in the report.
Note: This parameter and the Omit communications lines prompt (OMTLINE parameter) are mutually exclusive.
You can enter multiple values for this parameter.
Top |
Specifies a list of up to 50 communications lines to omit. Jobs that use a remote device connected through any of the specified communications lines are excluded from the report.
Note: This parameter and the Select communications lines prompt (SLTLINE parameter) are mutually exclusive.
You can enter multiple values for this parameter.
Top |
Specifies a list of up to 50 communications controllers to select. Only jobs that use a device connected to one of the specified controllers are included in the report.
Note: This parameter and the Omit control units prompt (OMTCTL parameter) are mutually exclusive.
You can enter multiple values for this parameter.
Top |
Specifies a list of up to 50 communications controllers to omit. Jobs that use a device connected to any of the specified controllers are excluded from in the report.
Note: This parameter and the Select control units prompt (SLTCTL parameter) are mutually exclusive.
You can enter multiple values for this parameter.
Top |
Specifies a list of up to 50 functional areas to select. Only jobs and users identified in one of the functional areas are included in the report.
A functional area is a list of job names and/or user names previously defined by the user. More information on functional areas is in the Performance Tools for iSeries book.
Note: This parameter and the Omit functional areas prompt (OMTFCNARA parameter) are mutually exclusive.
You can enter multiple values for this parameter.
Top |
Specifies a list of up to 50 functional areas to omit. Jobs and users identified in any of the functional areas are excluded from the report.
A functional area is a list of job names and/or user names previously defined by the user. More information on functional areas is in the Performance Tools for iSeries book.
Note: This parameter and the Select functional areas prompt (SLTFCNARA parameter) are mutually exclusive.
You can enter multiple values for this parameter.
Top |
Specifies whether or not you want to omit printing the system tasks.
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 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:
Top |
Specifies the job description used to submit the job for batch processing.
The possible job description values are:
The possible library values are:
Top |
Example 1: Submitting a Batch Job
PRTJOBRPT MBR(DTA071588A)
This command submits a batch job to print a report on all jobs in all intervals in the member DTA071588A of the performance data files in library QPFRDATA. The report title is taken from the text of that member.
Example 2: Selecting Intervals to Include in Report
PRTJOBRPT MBR(DTA071588A) PERIOD(*SELECT)
This command submits a job to print a report from the same data, but first shows a screen where a user interactively selects which intervals to include.
Example 3: Reporting on a Specific Time Period
PRTJOBRPT MBR(DTA071588A) PERIOD((2330)(0130))
This command submits a job to print a report on the data collected from 11:30 PM on the first day of collection through 1:30 AM on the last day of collection. However, if data collection started and ended on the same day, an error message is printed instead, because the specified ending date and time is before the specified starting date and time.
Example 4: Printing a Report Interactively
PRTJOBRPT MBR(DTA071588A) SLTUSRID(D46*) JOBD(*NONE)
This command interactively prints a report for all jobs with a user ID starting with D46.
Example 5: Printing a Report Interactively
PRTJOBRPT MBR(DTA071588A) SLTJOB(D46*/*N) JOBD(*NONE)
This command performs the same function as the previous example.
Top |
*ESCAPE Messages
Top |