Work with Active Jobs (WRKACTJOB)

Where allowed to run: All environments (*ALL)
Threadsafe: No 		Parameters
Examples
Error messages

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.

Top

 

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, *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

Top

 

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.

Top

 

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.

Top

 

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.

Top

 

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.

Top

 

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.

Top

 

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.

*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.

Top

 

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.

Top

 

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.

Top

 

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.

Top

 

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.

Top