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