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.

Restriction: You must have *JOBCTL special authority to use this command.

Parameters

Keyword	Description	Choices	Notes
OUTPUT	Output	, FILE, *BOTH	Optional, Positional 1
INTERVAL	Interval length	1-900, 5	Optional
SEQ	Sequence	CPU, DBCPU, IO, 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 MBR parameter and the library specified for the 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.
interval-length: 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.
*DBCPU: Jobs and tasks are ordered by the amount of processing time that they have used to perform database processing. Those using the greatest amounts of database CPU 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.
*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 parameter.

60: The data is collected and written to the database file 60 times.
number-of-intervals: 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 parameter.

QAITMON: The standard member name, QAITMON, is used.
member-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 parameter.

QPFRDATA: The IBM-supplied performance data library, QPFRDATA, is used to locate the database file.
library-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.