Print Activity Report (PRTACTRPT)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Print Activity Report (PRTACTRPT) command generates reports based on the data collected by the Work With System Activity (WRKSYSACT) command.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| MBR | Member | Name, QAITMON | Optional, Positional 1 |
| LIB | Library | Name, QPFRDATA | Optional, Positional 2 |
| TITLE | Title | Character value, *BLANK | Optional, Positional 3 |
| RPTTYPE | Report type | *SUMMARY, *DETAIL, *ALL | Optional |
| 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 | ||
| SEQ | Sequence | *JOBTASK, *USER, *PTY, *CPU, *TOTALIO, *SYNCIO, *ASYNCIO, *FAULT, *SDBREAD, *SDBWRITE, *SNDBREAD, *SNDBWRITE, *ADBREAD, *ADBWRITE, *ANDBREAD, *ANDBWRITE | Optional |
| NBRJOBS | Number of jobs | 1-32767, 10, *ALL | Optional |
| JOB | Job name | Name, PRTACTRPT, *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 |
Member (MBR)
Specifies the member where the performance data was saved by the Work with System Activity (WRKSYSACT) command.
- QAITMON
- The standard member name, QAITMON, is used.
- name
- Specify the name of the member that contains the performance data.
| Top |
Library (LIB)
Specifies the library where the performance data file, QAITMON, is stored.
- QPFRDATA
- The performance data is stored in the IBM-supplied performance data library, QPFRDATA.
- name
- Specify the name of the library where the data file is stored.
| Top |
Title (TITLE)
Specifies the title for the activity report that is generated.
- *BLANK
- No title is placed on the activity report.
- character-value
- Specify a title for the activity report. Specify up to 50 characters enclosed in apostrophes.
| Top |
Report type (RPTTYPE)
Specifies the type of activity report to be generated.
- *SUMMARY
- Lists the top ten entries, as measured over the entire time frame specified by the PERIOD parameter, according to processing unit utilization and number of I/O operations performed.
- *DETAIL
- For each interval specified by the PERIOD parameter, the number of entries specified by the NBRJOBS parameter are listed in the order specified by the SEQ parameter.
- *ALL
- Generates the summary activity report and the detailed activity report.
| Top |
Time period for report (PERIOD)
Specifies the time period for the report. The following values can be coded in this parameter, which contains two lists of two elements each. Data collected before the specified starting time and date and after the specified ending time and date is not shown.
Element 1: Starting time and date
Element 1: Starting time
- *FIRST
- The collected data that is available for the first interval on the specified starting date is included in the report.
- time
- Specify the time at which or after which the data must have been collected to be included in the report. The time is specified as 4 or 6 digits (hhmm or hhmmss), where hh is the hour, mm is the minute, and ss is the second.
The time can be specified with or without a time separator:
- Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.
- With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
Element 2: Starting date
- *FIRST
- The collected data that is available on or after the specified starting time on the first day of the performance data collection is included in the report.
- date
- Specify the starting date on which or after which the data must have been collected to be included in the report. The date must be entered in the same format as specified for the job.
Element 2: Ending time and date
Element 1: Ending time
- *LAST
- The collected data that is available through the last interval on the specified ending date is included in the report.
- time
- Specify the time before which the data must have been collected to be included in the report. The time is specified as 4 or 6 digits (hhmm or hhmmss), where hh is the hour, mm is the minute, and ss is the second.
The time can be specified with or without a time separator:
- Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.
- With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
Element 2: Ending date
- *LAST
- The collected data that is available up to the specified ending time on the last day of the performance data collection is included in the report.
- date
- Specify the ending date on which or before which the data must have been collected to be included in the report. The date must be entered in the same format as specified for the job.
| Top |
Sequence (SEQ)
Specifies the field by which the jobs and tasks are ranked and then listed on the detailed activity report. This parameter is valid only when *DETAIL or *ALL is specified for the RPTTYPE parameter.
- *CPU
- List the entries in descending order according to processing unit utilization.
- *JOBTASK
- List the entries alphabetically according to the job or task name.
- *USER
- List the entries alphabetically according to the user profile.
- *PTY
- Lists the entries in descending order according to priority.
- *TOTALIO
- Lists the entries in descending order according to the total number of synchronous and asynchronous I/O operations performed.
- *SYNCIO
- List the entries in descending order according to the total number of synchronous I/O operations performed.
- *ASYNCIO
- List the entries in descending order according to the total number of asynchronous I/O operations initiated.
- *FAULT
- List the entries in descending order according to the number of Process Access Group faults which occurred.
- *SDBREAD
- List the entries in descending order according to the number of synchronous database read operations performed.
- *SDBWRITE
- List the entries in descending order according to the number of synchronous database write operations performed.
- *SNDBREAD
- List the entries in descending order according to the number of synchronous non database read operations performed.
- *SNDBWRITE
- List the entries in descending order according to the number of synchronous non database write operations performed.
- *ADBREAD
- List the entries in descending order according to the number of asynchronous database read operations initiated.
- *ADBWRITE
- List the entries in descending order according to the number of asynchronous database write operations initiated.
- *ANDBREAD
- List the entries in descending order according to the number of asynchronous non database read operations initiated.
- *ANDBWRITE
- List the entries in descending order according to the number of asynchronous non database write operations initiated.
| Top |
Number of jobs (NBRJOBS)
Specifies the number of entries to be listed for each interval in the detailed activity report. This parameter is valid only when *DETAIL or *ALL is specified for the RPTTYPE parameter.
- 10
- List ten entries for each interval.
- *ALL
- List all the entries contained in the collected data.
- 1-32767
- Specify the number of entries to be listed for each interval.
| Top |
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 (JOBD) parameter.
Note: If JOBD(*NONE) is specified, job processing is performed interactively.
- PRTACTRPT
- The command name is used for the job name.
- *MBR
- The name selected for the performance data member in the Member (MBR) parameter is used.
- name
- Specify the name to be used for any and all batch jobs.
| Top |
Job description (JOBD)
Specifies the job description used to submit the job for batch processing.
Single values
- *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.
Qualifier 1: Job description
- QPFRJOBD
- The IBM-supplied job description, QPFRJOBD, is used.
- name
- Specify the name of the job description to be used.
Qualifier 2: Library
- *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.
- name
- Specify the library in which the job description is located.
| Top |
Examples
Example 1: Generating a Summary Report
PRTACTRPT
This command submits a batch job that generates a summary activity report using the performance data found in the default member QAITMON located in the default library QPFRDATA. The report covers the entire measurement period, and the title of the report is left blank.
Example 2: Generating a Summary and Detailed Activity Report
PRTACTRPT MBR(JUNE01) TITLE('Activity Report for June 1st')
RPTTYPE(*ALL) SEQ(*CPU)
This command submits a batch job that generates both a summary and a detailed activity report. The performance data comes from member JUNE01 located in the default library QPFRDATA. The report covers the entire measurement period, and the title of the report is 'Activity Report for June 1st'. The detailed activity report lists ten entries in descending order according to CPU utilization for each interval.
| Top |
Error messages
*ESCAPE Messages
- PFR7010
- No data in member to print.
- PFR7017
- Cannot print activity report.
| Top |