SPOOL-QUEUE

#### Search Results

Search

# SPOOL-QUEUE

File | 11
Statement | `FIND`
Task | Read spool queue. This view retrieves spool queue information such as jobname, job number, class, queue, number of spool records, etc.

## Fields

Dictionary Field Name | F/L | Mu | DE | Remarks
--- | --- | --- | --- | ---
`ERROR-CODE` | N3 |  |  |
`ERROR-TEXT` | A58 |  |  |
`NODE` | N5 |  | D |
`NODE-NAME` | A16 |  | D |
`SYSTEM-MESSAGE-CODE` | A10 |  |  |
`HOLD` | A3 |  | D |
`JOB-NAME` | A8 |  | D |
`JOB-NUMBER` | N7 |  | D |
`JOB-ID` | A8 |  | D |
`STATUS` | A9 |  | D |
`PRIORITY` | N3 |  | D |
`USER` | A8 |  | D |
`DATE-XEQ-START` | A8 |  | D |
`DATX-XEQ-START` | D |  | D |
`TIME-XEQ-START` | N6 |  | D |
`TIMX-XEQ-START` | T |  | D |
`DATE-XEQ-STOP` | A8 |  | D |
`DATX-XEQ-STOP` | D |  | D |
`TIME-XEQ-STOP` | N6 |  | D |
`TIMX-XEQ-STOP` | T |  | D |
`RECORD-COUNT` | N9 |  | D |
`CLASS` | A8 |  | D |
`QUEUE` | A3 |  | D |
`DESTINATION` | A8 |  | D |
`ORIGIN` | A8 |  | D |
`SYSTEM-ID` | A4 |  | D |
`TYPE` | A3 |  | D |
`SPOOL-UTILIZATION` | B1 |  | D |
`GROUP-ID` | A20 |  | D |
`ROOM` | A4 |  | D |
`PROGRAMMER-NAME` | A20 |  | D |
`MESSAGE-CLASS` | A1 |  | D |
JOB-CLASS | A1 |  | D |
`TIME-ON-READER` | N6 |  | D |
`DATE-ON-READER` | A8 |  | D |
`CARD-COUNT` | N7 |  | D |
`OUTDISP` | A6 |  | D |
`MAX-RETURN-CODE` | A10 |  | D |
`SUBMITTER` | A8 |  | D | JES3 only
`WLM-QUEUE-POSITION` | N7 |  | D |
`WLM-SERVICE-CLASS` | A8 |  | D |

## Relevant Error Codes

Code | Text
--- | ---
711 | Logical Error occurred in Common JES Interface.
712 | Request to Common JES Interface failed.
713 | Jobname and Job ID missing. One of them required.
724 | Requested job not found.
729 | Invalid job `TYPE`, specify `JOB`, STC or `TSU`.
830 | JES interface is not active.

## Field Descriptions

Field Name | Type/Length
--- | ---
`CARD-COUNT` | (N7)

Number of cards submitted to internal reader.

Field Name | Type/Length
--- | ---
`CLASS` | (A8)

Job class. For valid classes, ask your system programmer.

Field Name | Type/Length
--- | ---
`DATE-ON-READER` | (A8)

Date when job was submitted to the internal reader.

Field Name | Type/Length
--- | ---
`DATE-XEQ-START` | (A8)

Date when job or queue entry started executing.

Field Name | Type/Length
--- | ---
`DATE-XEQ-STOP` | (A8)

Date when job or queue entry finished executing.

Field Name | Type/Length
--- | ---
`DATX-XEQ-START` | (A8)

Date when job or queue entry started executing - in internal format.

Field Name | Type/Length
--- | ---
`DATX-XEQ-STOP` | (A8)

Date when job or queue entry finished executing - in internal format.

Field Name | Type/Length
--- | ---
`DESTINATION` | (A8)

JES destination of job.

Field Name | Type/Length
--- | ---
`GROUP-ID` | (A20)

Unique identifier defined by JES.

Field Name | Type/Length
--- | ---
`HOLD` | (A3)

`YES` indicates job is in hold.

`DUP` indicates a temporary hold because of a duplicate job in the system.

Field Name | Type/Length
--- | ---
`JOB-CLASS` | (A1)

JES job class where the job is to be executed.

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

Job number or TSN of job in alphanumeric format.

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

Name of the job.

Field Name | Type/Length
--- | ---
`JOB-NUMBER` | (N7)

Job number assigned by JES.

Field Name | Type/Length
--- | ---
`MAX-RETURN-CODE` | (A10)

Return code information for the job. The information is returned in one of the following formats:

`CC nnnn` | Job ended normally or by `CC nnnn`.
`ABEND Sxxx` | Job abended with system abend code `xxx`.
`ABEND Unnnn` | Job abended with user abend code `nnnn`.
`CANCELED` | Job was canceled.
`CONV ABEND` | Converter abended.
`JCL ERROR` | Job failed due to JCL error.
`SEC ERROR` | Job failed due to security error.

Field Name | Type/Length
--- | ---
`MESSAGE-CLASS` | (A1)

Output message class.

Field Name | Type/Length
--- | ---
`ORIGIN` | (A8)

JES3 job origin.

Field Name | Type/Length
--- | ---
`OUTDISP` | (A6)

Output disposition. Possible values are `WRITE`, `HOLD`, `KEEP` or `LEAVE`.

Field Name | Type/Length
--- | ---
`PROGRAMMER-NAME` | (A20)

Name of the user who submitted the job to identify the person or group responsible. This value is inherited from the job card.

Field Name | Type/Length
--- | ---
`PRIORITY` | (N3)

Priority of job.

Field Name | Type/Length
--- | ---
`QUEUE` | (A3)

Queue in which the job resides. Possible values:

`IN` | Input queue.
`NJE` | NJE receive/transmit queue.
`OUT` | Output queue.
`XEQ` | Job is executing.

Field Name | Type/Length
--- | ---
`RECORD-COUNT` | (N9)

Number of records in spool.

Field Name | Type/Length
--- | ---
`ROOM` | (A4)

Room number of user who submitted the job.

Field Name | Type/Length
--- | ---
`SPOOL-UTILIZATION` | (B1)

Percentage of spool used.

Field Name | Type/Length
--- | ---
`STATUS` | (A9)

Status of job.

Possible values:

`ACTIVE` | Job has been selected.
`AVAILABLE` | Job is available.
`WAITING` | Job is waiting (JES3 only).

Field Name | Type/Length
--- | ---
`SUBMITTER` | (A8)

The submitting user ID of the job.

Field Name | Type/Length
--- | ---
`SYSTEM-ID` | (A4)

ID of the system on which the job is/was processed.

Field Name | Type/Length
--- | ---
`TIME-ON-READER` | (N6)

Time of day when job was submitted to the internal reader.

Field Name | Type/Length
--- | ---
`TIME-XEQ-START` | (N6)

Time of day when job or queue entry started executing.

Field Name | Type/Length
--- | ---
`TIME-XEQ-STOP` | (N6)

Time of day when job or queue entry finished executing.

Field Name | Type/Length
--- | ---
`TIMX-XEQ-START` | (N6)

Time of day when job or queue entry started executing - in internal format.

Field Name | Type/Length
--- | ---
`TIMX-XEQ-STOP` | (N6)

Time of day when job or queue entry finished executing - in internal format.

Field Name | Type/Length
--- | ---
`TYPE` | (A3)

Type of job. Possible values:

Value | Explanation
--- | ---
`JOB` | Batch job.
`STC` | Started task.
`TSU` | TSO user.

Field Name | Type/Length
--- | ---
`USER` | (A8)

Owner of the job.

Field Name | Type/Length
--- | ---
`WLM-QUEUE-POSITION` | (N7)

Position on the WLM queue for the job.

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

WLM service class name.

#### Note

For z/OS JES2 or JES3, the following fields are only obtained from the spool queue if JOB-NAME or JOB-NUMBER have also been specified with the FIND request:

    PROGRAMMER-NAME
    ROOM
    MESSAGE-CLASS
    CARD-COUNT
    RECORD-COUNT
    TIME-ON-READER,  TIMX-ON-READER
    DATE-ON-READER,  DATX-ON-READER
    TIME-XEQ-START,  TIMX-XEQ-START
    DATE-XEQ-START,  DATX-XEQ-START
    TIME-XEQ-STOP,   TIMX-XEQ-STOP
    DATE-XEQ-STOP,   DATX-XEQ-STOP

Consequently, these fields can only be used as search criteria in combination with `JOB-NAME` or `JOB-NUMBER`.

### On this page

- Fields
- Relevant Error Codes
- Field Descriptions