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