ACTIVE-JOBS

#### Search Results

Search

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

## Fields

Dictionary Field Name | F/L | Mu | DE | Remarks
--- | --- | --- | --- | ---
`ERROR-CODE` | N3 |  |  |
`ERROR-TEXT` | A58 |  |  |
`NODE` | N5 |  | D |
`NODE-NAME` | A16 |  | D |
`CPU-USED` | N7.2 |  | D |
`DISPATCHING-PRIORITY` | B1 |  | D |
`JOB-ID` | A8 |  | D |
`JOB-NAME` | A8 |  | D |
`JOB-NUMBER` | N7 |  | D |
`STATUS` | A8 |  | D |
`SYSTEM-MESSAGE-CODE` | A10 |  |  |
`TYPE` | A6 |  | D |
`REGION-ALLOCATED-BELOW` | N7 |  | D |
`REGION-LIMIT-BELOW` | N7 |  | D |
`REGION-ALLOCATED-ABOVE` | N7 |  | D |
`REGION-LIMIT-ABOVE` | N7 |  | D |
`Dictionary Field Name` | F/L | Mu | DE | Remarks
`ADDRESS` | B4 |  |  |
`ASID` | N4 |  | D |
`CLASSES` | A6 |  | D | Relevant wirh `TYPE=JOB`
`DISPATCHABLE` | A3 |  | D |
`ECPU-USED` | N7.2 |  | D |
`JES-INIT-ID` | A4 |  | D | Relevant with `TYPE=JOB`
`PROC-NAME` | A8 |  | D |
`QUESCE` | A3 |  |  |
`REGION` | N7 |  | D |
`RESOURCE-GROUP` | A8 |  |  |
`SERVER` | A3 |  |  |
`SERVICE-CLASS` | A8 |  |  |
`SERVICE-CLASS-PERIODE` | N3 |  |  |
`SIO-CUNT` | N11 |  | D |
`STEP-NAME` | A8 |  | D |
`TCB` | B4 |  | D |
`WORKLOAD` | A8 |  |  |
`ZIIP-USED` | N7.2 |  | D | Normalized time
`ZIIP-GP-USED` | N7.2 |  | D |

## Relevant Error Codes

Code | Text
--- | ---
830 | JES interface is not active.
831 | Error during queue initialization

## Field Descriptions

Field Name | Format/Length
--- | ---
`ADDRESS` | (B4)

ASCB address.

Field Name | Format/Length
--- | ---
`ASID` | (N4)

Address space identifier.

Field Name | Format/Length | Remarks
--- | --- | ---
`CLASSES` | (A6) | Relevant when `TYPE=JOBS`: batch initiatior classes

Field Name | Format/Length
--- | ---
CPU-USED | (N7.2)

Field Name | Format/Length
--- | ---
`DISPATCHABLE` | (A3)

Dispatchability of address space. Possible values:

Value | Explanation
--- | ---
`NO` | Address space is not dispatchable
`YES` | Address space is dispatchable

Field Name | Format/Length
--- | ---
`DISPATCHING-PRIORITY` | (B1)

Dispatching priority.

Field Name | Format/Length
--- | ---
`ECPU-USED` | (N7.2)

The amount of CPU consumed by the address space / task including preemptable-class CPU time (format `SSSSS.HH`).

Field Name | Format/Length
--- | ---
`JES-INIT-ID` | (A4)

Relevant when `TYPE=JOB`: JES batch initiator identifier.

Field Name | Format/Length
--- | ---
`JOB-ID` | (A8)

Job number in alphanumeric format. In case of numeric job numbers, the job number will also be returned in field `JOB-NUMBER`.

Field Name | Format/Length
`JOB-NAME` | (A8)

Name of the job. This is taken from the job card.

Field Name | Format/Length
--- | ---
`PROC-NAME` | (A8)

Name of the procedure currently being executed.

Field Name | Format/Length
--- | ---
`QUIESCE` | (A3)

Quiesce Indicator (`YES`/`NO`) (indicates if address space is quiesced).Relevant when `TYPE=JOB`: JES batch initiator identifier.

Field Name | Format/Length
--- | ---
`REGION` | (N7)

Amount of real storage used by the address space in Kbytes.

Field Name | Format/Length
--- | ---
`REGION-ALLOCATED-BELOW` | (N7)

Amount of virtual storage allocated below the 16 MB line (in KB).

Field Name | Format/Length
--- | ---
`REGION-LIMIT-BELOW` | (N7)

Amount of virtual storage that can be allocated below the 16 MB line (in KB).

Field Name | Format/Length
--- | ---
`REGION-ALLOCATED-ABOVE` | (N7)

Amount of virtual storage allocated above the 16 MB line (in KB).

Field Name | Format/Length
--- | ---
`REGION-LIMIT-ABOVE` | (N7)

Amount of virtual storage that can be allocated above the 16 MB line (in KB).

Field Name | Format/Length
--- | ---
`RESOURCE-GROUP` | (A8)

Resource Group Name .

Field Name | Format/Length
--- | ---
`SERVER` | (A8)

Server indicator (`YES`/`NO`) indicates whether or not resource goals are being honored.

Field Name | Format/Length
--- | ---
`SERVICE-CLASS` | (A8)

Service class name .

Field Name | Format/Length
--- | ---
`SERVICE-CLASS-PERIOD` | (N3)

Service class period .

Field Name | Format/Length
--- | ---
`SIO-COUNT` | (N11)

Number of I/O operations performed so far.

Field Name | Format/Length
--- | ---
`STATUS` | (A8)

Possible values:

Value | Explanation
--- | ---
blank | Address space is swapped in.
`NON-SWAP` | Address space is non-swappable.
`SWAP-OUT` | Address space is swapped out.
`TERM` | Address space is terminating.
`V=R` | Running in real memory.

Field Name | Format/Length
--- | ---
`STEP-NAME` | (A8)

Name of the step currently being executed.

Field Name | Format/Length
--- | ---
`TCB` | (B4)

TCB address of first ready task for this address space.

Field Name | Format/Length
--- | ---
`TYPE` | (A6)

Type of job. Possible values:

Job Type | Explanation
--- | ---
`JOB INI STC TSU` | Batch job JES initiator started task TSO user

Field Name | Format/Length
--- | ---
`WORKLOAD` | (A8)

Workload name .

Field Name | Format/Length
--- | ---
`ZIIP-USED` | (N7.2)

[Normalized] Enclave zIIP time - the amount of time the enclave has run on zIIP (format `SSSSS.HH`).

To reset the zIIP times at job step, reset the fields in the job step initiation exit `IEFUSI`. An example is supplied by IBM in `SYS1.SAMPLIB(IEEUSI)`. You can reset the zIIP time at job step with any program running in Key 0.

Field Name | Format/Length
--- | ---
`ZIIP-GP-USED` | (N7.2)

Eligible zIIP time on GP - the amount of time the enclave has run on GP, which was eligible to run on zIIP (format `SSSSS.HH`).

## Examples

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

Result :

    JOB-NAME JOB-ID  TYPE   CPU       STATUS
      ...
      XCOM148  2975    STC    68.04     NON-SWAP
      INIT             INI              IDLE
      DELINDEX 2988    JOB    13.45
      WKK      2802    TSU     2.95     SWAP-OUT
      ...

### On this page

- Fields
- Relevant Error Codes
- Field Descriptions
- Examples