Work with System Activity (WRKSYSACT)
Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Work with System Activity (WRKSYSACT) command allows you to interactively work with the jobs and tasks currently running in the system. Besides having the capacity to view this data on the display station, the user may also direct the data to be stored in a database file for future use.
Restrictions:
- You must have job control (*JOBCTL) special authority to use this command.
Top |
Parameters
Keyword | Description | Choices | Notes |
---|---|---|---|
OUTPUT | Output | *, *FILE, *BOTH | Optional, Positional 1 |
INTERVAL | Interval length | 1-900, 5 | Optional |
SEQ | Sequence | *CPU, *IO, *SQLCPU, *STGALC, *STGDLC, *STGNET | Optional |
INFTYPE | Type of information | *ALL, *JOBS, *TASKS | Optional |
NBRITV | Number of intervals | Integer, 60 | Optional |
MBR | Member | Name, QAITMON | Optional |
LIB | Library | Name, QPFRDATA | Optional |
Top |
Output (OUTPUT)
Specifies whether the output from the command is shown on the display station that entered the command, written to a physical database file, or both.
- *
- The output is shown on the display station.
- *FILE
- The output is written to the database file QAITMON using the member specified for the Member (MBR) parameter and the library specified for the Library (LIB) parameter.
- *BOTH
- The output is shown on the display station and written to the database file. The statistics are put in the QAITMON file each time the display is refreshed. This does not include the data presented on the initial display of the Work with System Activity display.
Top |
Interval length (INTERVAL)
Specifies the number of seconds between the times when the data is refreshed in automatic refresh mode and/or written to the database file. Valid values range from 1 through 900 seconds.
- 5
- The data is refreshed every 5 seconds.
- 1-900
- Specify the number of seconds (1-900) between refreshes.
Top |
Sequence (SEQ)
Specifies the sequence of the jobs and tasks being displayed or written to the database file.
- *CPU
- Jobs and tasks are ordered by the amount of processing time they have used during the interval. Those using the greatest amounts of processing time are presented first.
- *IO
- Jobs and tasks are ordered by the number of I/O operations performed during the interval. Those performing the most I/O operations are presented first.
- *SQLCPU
- Jobs and tasks are ordered by the amount of processing time that they have used to perform SQL processing. Those using the greatest amounts of SQL CPU are presented first.
- *STGALC
- Tasks or threads are ordered by the amount of allocated storage. Allocated storage is the amount of storage (in pages) assigned to perform this task or thread. Those tasks or threads that are allocating the highest amount of storage are presented first.
- *STGDLC
- Tasks or threads are ordered by the amount of deallocated storage. Deallocated storage is the amount of storage (in pages) that has been released from performing this task or thread. Those tasks or threads that are deallocating the highest amount of storage are presented first.
- *STGNET
- Tasks or threads are ordered by the amount of net storage. Net storage is the difference between the allocated storage and the deallocated storage. Those tasks or threads that are deallocating the greatest difference between the allocated storage and the deallocated storage are presented first.
Top |
Type of information (INFTYPE)
Specifies the type of information that is shown or written to the database file.
- *ALL
- Both jobs and tasks are shown or written to the database file.
- *JOBS
- Only jobs are shown or written to the database file.
- *TASKS
- Only tasks are shown or written to the database file.
Top |
Number of intervals (NBRITV)
Specifies the number of times the data is collected and written to the database file. This parameter is valid only when *FILE is specified for the Output (OUTPUT) parameter.
- 60
- The data is collected and written to the database file 60 times.
- number
- Specify the number of times to collect the performance data and write to the database file.
Top |
Member (MBR)
Specifies the database file member where the output for the collected data is stored. If the member does not exist, it is automatically created and added to the database file. This parameter is valid only when *FILE or *BOTH is specified for the Output (OUTPUT) parameter.
- QAITMON
- The standard member name, QAITMON, is used.
- name
- Specify the name of the member in which to store the collected data.
Top |
Library (LIB)
Specifies the library where the database file QAITMON is located. The file QAITMON is automatically created if it does not exist in the specified library. This parameter is valid only when *FILE or *BOTH is specified for the Output (OUTPUT) parameter.
- QPFRDATA
- The IBM-supplied performance data library, QPFRDATA, is used to locate the database file.
- name
- Specify the name of the library where the database file is located.
Top |
Examples
Example 1: Working with Jobs and Tasks
WRKSYSACT
This command displays the Work with System Activity panel, showing both jobs and tasks in descending order of processing time used.
Example 2: Working with Jobs Only
WRKSYSACT OUTPUT(*BOTH) INFTYPE(*JOBS) MBR(JOBACT)
This command displays the Work with System Activity panel, showing jobs only and writes this information to member JOBACT of database file QAITMON located in default library QPFRDATA.
Top |
Top |