WRKACTJOB (Work with Active Jobs)

WRKACTJOB Command syntax diagram

 

Purpose

The Work with Active Jobs (WRKACTJOB) command allows the user to work with performance and status information for the active jobs in the system. The SEQ criteria can be changed by operations on the display. Selection values (CPUPCTLMT, SBS, RSPLMT, JOB) can also be changed by operations on the display.

 

Optional Parameters

OUTPUT

Specifies whether the output from the command is shown at the requesting workstation or printed with the job's spooled output. More information on this parameter is in commonly used parameters.

*: Output requested by an interactive job is shown on the display. Output requested by a batch job is printed with the job's spooled output.

*PRINT: The output is printed with the job's spooled output.

RESET

Specifies whether the active job statistics are reset.

*NO: The active job statistics are not reset. The measurement time interval is extended (similar to pressing the F5 key) if a previous display active jobs 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 (0) is used (similar to pressing the F13 key). All active jobs are displayed.

SBS

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

*ALL: The active jobs in all subsystems are displayed. System jobs that are not associated with any subsystem are also displayed.

subsystem-name: Specify the name of the subsystem to be displayed. All active jobs in this subsystem (including the monitor) are displayed. Up to 25 subsystem names can be specified.

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.

CPU-percent-limit: Specify the minimum processing time percent limit that a job must have to be included on the display. Valid values range from 0.1 through 99.9.

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.

response-time-limit: Specify the minimum response time limit that a job must have to be included on the display. Valid values range from 0.1 through 999.9.

SEQ

Specifies the sequence of the active jobs that are shown.

*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 monitors (with the jobs in the subsystem grouped under each monitor job) are put in alphabetical order and presented before system (SYS) jobs. The system jobs (start operating system, system arbiter, and LU services) are put in alphabetical order by job name, and are presented after the subsystem monitors and jobs in the subsystems.

*JOB: Jobs are put in alphabetical order by job name.

*TYPE: Jobs are put in alphabetical order by job type and job name within the same type.

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

*CPU: Jobs are ordered by the amount of processing time they have used since the job started. The largest values are presented first.

*INT: Jobs are ordered by the number of operator interactions that have occurred during the measurement interval. The largest values are presented first. Jobs that have no interactions (blank interaction field) come after jobs with 0 interactions.

*RSP: Jobs are ordered by the average response time during the measurement interval. The largest values are presented first. Jobs that have no interactions (blank interaction field) come after jobs with 0 response time.

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

*CPUPCT: Jobs are ordered by the percent of CPU resource they have used during the measurement interval. The largest values are presented first.

*USER: Jobs are ordered alphabetically by user name.

*FUNCTION: Jobs are put in alphabetical order by the contents of the function field.

*STS: Jobs are put in alphabetical order by the contents of the status field.

*NUMBER: Jobs are ordered by job number. The largest values are presented first.

*THREADS: Jobs are ordered by the number of active threads. The jobs with the largest number of active threads are presented first.

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.

*ALL: All the active jobs are displayed.

*SYS: All active system jobs are 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 sybsystem monitors are displayed.

generic*: Specify all active jobs, that meet the criteria, that are to be displayed. System jobs and subsystem moniters are not displayed using this parameter.

job-name: Specify the active job that is to be displayed. System jobs and subsystem monitors are not displayed using this parameter.

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.

automatic-refresh-interval: Specify the delay time (in seconds) for automatic refresh. Valid values range from 5 through 999.

Examples for WRKACTJOB

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 for WRKACTJOB

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