Work with System Activity (WRKSYSACT)

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:

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

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.

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.

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.

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.

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.

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.

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.

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.

Error messages

*ESCAPE Messages

CPFC702
Work with System Activity already active by user &4.