ACTIVE-JOBS

File 29
Statement FIND
Task Retrieve the tasks that are currently active in the system and get information about them; for example, the amount of CPU time already used by the tasks.

Corresponds to command /sta p: retrieve tasks of Type 2 or 3.


Relevant Error Codes

Code Text
699 Not enough main storage available.
728 You are not allowed to see this job.
750 Invalid operand within operand list.
751 Not enough memory to execute the function.
799 Entire System Server internal error.
988 Invalid task type detected.

Field Descriptions

Field Name Format/

Length/

Desc/

Mu
Description
ACCOUNT-NUMBER (A8) Account number of the job.
CPU-MAX (N7.2) The CPU time limit for the job.
CPU-USED (N7.2) The amount of CPU time consumed by the job/address space. Format: SSSSS.HH.
DISPATCHING-PRIORITY (B1) The run priority of the task.
HOLD (A3)

Indicates if a job is in HOLD status.

Possible values: NO, YES
JOB-ID (A8)

D

Job number in alphanumeric format. Must be used for BS2000 V10 with alphanumeric TSNs. In case of numeric job numbers, the job number will also be returned in field JOB-NUMBER.
JOB-NAME (A8) Name of the job.
JOB-NUMBER (N7) TSN (task sequence number), if numeric. This field will contain zero in case of alphanumeric TSN.
STATUS (A8) Same as field TYPE
TYPE (A6) Type of job. Possible values: BATCH, DIALOG, TP
TYPE-NUMBER (N1) Numeric job type identifier. For example, 2 for batch jobs, 3 for dialog tasks.
USER (A8) User ID of job.

Examples

The following example applies to all operating systems:

    ...
    FIND ACTIVE-JOBS WITH NODE = 148 AND CPU-USED < 1000
      IF ACTIVE-JOBS.ERROR-CODE NE 0
        WRITE ACTIVE-JOBS.ERROR-TEXT
        ESCAPE ROUTINE
      END-IF
      DISPLAY ACTIVE-JOBS.JOB-NAME
              ACTIVE-JOBS.JOB-ID
              ACTIVE-JOBS.TYPE
              ACTIVE-JOBS.STATUS
              ACTIVE-JOBS.CPU-USED
    END-FIND
    ...