Work with Active Jobs (WRKACTJOB)

The Work with Active Jobs (WRKACTJOB) command allows you to work with performance and status information for the active jobs in the system. The sequence of jobs can be changed with the Sequence (SEQ) parameter or through operations on the display. Other parameters allow the selection of jobs to be shown on the display. The selection parameters can also be changed by operations on the display.

Parameters

Keyword Description Choices Notes
OUTPUT Output *, *PRINT Optional, Positional 1
RESET Reset status statistics *NO, *YES Optional, Positional 2
SBS Subsystem Single values: *ALL
Other values (up to 25 repetitions): Name		 Optional
CPUPCTLMT CPU percent limit 0.1-99.9, *NONE Optional
RSPLMT Response time limit 0.1-999.9, *NONE Optional
SEQ Sequence *SBS, *AUXIO, *CPU, *CPUPCT, *CURUSR, *FUNCTION, *INT, *JOB, *NUMBER, *POOL, *PTY, *RSP, *STS, *THREADS, *TMPSTG, *TYPE, *USER Optional
JOB Job name Qualifier list Optional
Qualifier 1: Job name Generic name, name, *ALL, *SYS, *SBS
INTERVAL Automatic refresh interval 5-999, *PRV Optional

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*
The output is displayed for interactive jobs or printed with the job's spooled output for non-interactive jobs.
*PRINT
The output is printed with the job's spooled output.

Reset status statistics (RESET)

Specifies whether the active job statistics are reset.

*NO
The active job statistics are not reset. The measurement time interval is extended if a previous WRKACTJOB command has run in the current job. All active jobs are displayed.
*YES
The active job statistics are reset. A measurement time interval of zero is used. All active jobs are displayed.

Subsystem (SBS)

Specifies the names of the subsystems (or all subsystems) whose active jobs are displayed.

Single values

*ALL
All active jobs in the system are displayed. System jobs that are not associated with any subsystem are also displayed.

Other values (up to 25 repetitions)

name
Specify the name of the subsystem to be displayed. All active jobs in this subsystem (including the monitor) are displayed.

CPU percent limit (CPUPCTLMT)

Specifies the minimum processing time percent value that a job must have before it is included on the display.

*NONE
There is no minimum processing time limit that a job must have to be displayed.
0.1-99.9
Specify the minimum processing time percent limit that a job must have to be included on the display.

Response time limit (RSPLMT)

Specifies the minimum response time limit that a job must have before it is included on the display.

*NONE
There is no minimum response time limit that a job must have to be displayed.
0.1-999.9
Specify the minimum response time limit that a job must have to be included on the display.

Sequence (SEQ)

Specifies the sequence of the active jobs that are displayed.

*SBS
The jobs are ordered on the basis of the subsystem in which they are running. Jobs that run in a subsystem (auto-start jobs, interactive jobs, batch jobs, readers, and writers) are put in alphabetical order by job name, and are indented under the subsystem with which they are associated. Subsystem monitor jobs (with the jobs in the subsystem grouped under each monitor job) are put in alphabetical order and presented before system jobs. The system jobs are put in alphabetical order by job name, and are presented after the subsystem monitors and jobs in the subsystems.
*AUXIO
Jobs are ordered by the number of auxiliary storage input/output (I/O) operations that have occurred during the measurement time interval. The largest values are presented first.
*CPU
Jobs are ordered by the amount of processing time they have used since the job started. The largest values are presented first.
*CPUPCT
Jobs are ordered by the percent of processing unit resource they have used during the measurement interval. The largest values are presented first.
*CURUSR
Jobs are put in alphabetical order by the user profile under which the initial thread is currently running.
*FUNCTION
Jobs are put in alphabetical order by the contents of the function field.
*INT
Jobs are ordered by the number of operator interactions that have occurred during the measurement interval. The largest values are presented first. Non-interactive jobs are shown last and have a blank interaction field.
*JOB
Jobs are put in alphabetical order by job name.
*NUMBER
Jobs are ordered by job number. The largest values are presented first.
*POOL
Jobs are ordered by the system pool in which they are running. The lowest values are presented first.
*PTY
Jobs are ordered by priority of running. The highest priority values (0) are presented first.
*RSP
Jobs are ordered by the average response time during the measurement interval. The largest values are presented first. Non-interactive jobs are shown last and have a blank interaction field.
*STS
Jobs are put in alphabetical order by the contents of the status field.
*THREADS
Jobs are ordered by the number of active threads. The jobs with the largest number of active threads are presented first.
*TMPSTG
Jobs are ordered by the amount of temporary storage used. The jobs using the most storage are presented first.
*TYPE
Jobs are put in alphabetical order by job type and job name within the same type.
*USER
Jobs are put in alphabetical order by user name.

Job name (JOB)

Specifies the name of the active jobs to be displayed. Only active jobs within selected subsystems (based on the SBS parameter) are displayed. Subsystem monitor names only appear when *ALL or *SBS is specified. System jobs only appear when *ALL or *SYS is specified.

Qualifier 1: Job name

*ALL
All the active jobs are displayed.
*SYS
All active system jobs are be displayed. If a value other than the default is specified in the SBS parameter when using this value, an error message is issued.
*SBS
All active subsystem monitors are displayed.
generic-name
Specify all active jobs, that meet the criteria, that are to be displayed. System jobs and subsystem monitors are not displayed using this parameter.
name
Specify the active job that is to be displayed. System jobs and subsystem monitors are not displayed using this parameter.

Automatic refresh interval (INTERVAL)

Specifies the interval (in seconds) to wait during the automatic refresh option. The default time is 300 seconds (5 minutes). Valid values range from 5 to 999 seconds. If this value is changed by the user, the value is saved and used as the default value. When automatic refresh is started the screen is refreshed automatically based on the time specified.

*PRV
The interval of time used in the previous invocation. Until an interval is specified, 300 seconds is used.
5-999
Specify the delay time (in seconds) for automatic refresh.

Examples

Example 1: Resetting Active Job Statistics 

WRKACTJOB   RESET(*YES)  CPUPCTLMT(2)

This command allows the user to work with a display with no jobs appearing; the active job statistics are reset and no job has used any processing unit time since the reset point. When the display appears, the F5 key may be pressed; this causes a display of all jobs that have exceeded 2 percent of the processing unit utilization since the reset point.

Example 2: Working With Jobs in a Subsystem 

WRKACTJOB   SBS(QINTER)  SEQ(*INT)

This command allows the user to work with all jobs in the QINTER subsystem. The sequence of the jobs is by the number of operator interactions, with the job with the most interactions appearing first.

Error messages

*ESCAPE Messages

CPF1093
Override of file device type not valid.
CPF9845
Error occurred while opening file &1.
CPF9846
Error while processing file &1 in library &2.
CPF9847
Error occurred while closing file &1 in library &2.
CPF9850
Override of printer file &1 not allowed.
CPF9851
Overflow value for file &1 in &2 too small.
CPF9871
Error occurred while processing.