SPOOL-QUEUE

File 11
Op-Sys z/OS, z/VSE, BS2000
Statement FIND
Task Read spool queue. This view retrieves spool queue information such as jobname, job number, class, queue, number of spool records, etc.

Common Fields for all Operating Systems

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  

Additional Fields Supported for z/OS, z/VSE

Dictionary Field Name F/L Mu DE Remarks
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  

Additional Fields Supported for z/OS

Dictionary Field Name F/L Mu DE Remarks
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  

Additional Fields Supported for z/VSE

Dictionary Field Name F/L Mu DE Remarks
ACCOUNT-NUMBER A8   D  
CLASS A8   D  
QUEUE A3   D  
DESTINATION A8   D  
ORIGIN A8   D  
COPIES N3   D  
DISP A1   D  
SYSTEM-ID A4   D  
PAGE-COUNT N5   D  
FORM A8   D  
SEGMENT-NUMBER N3   D  
REAL-RECORD-COUNT N9   D  

Additional Fields Supported for BS2000

Dictionary Field Name F/L Mu DE Remarks
SYSTEM-CODE B2      
ACCOUNT-NUMBER A8   D  
COPIES N3   D  
ORIGINATOR-TSN N5   D  
CPU-MAX N7.2      
TYPE-NUMBER N1      
SIZE A6      
CPU-USED N7.2      
DEVICE A8   D  
ORIGINATOR-JOB-ID A8   D  

Relevant Error Codes

Code Text z/OS z/VSE BS2000
699 Not enough main storage available.   X X
711 Logical Error occurred in Common JES Interface. X    
712 Request to Common JES Interface failed. X    
713 Jobname and Job ID missing. One of them required. X    
724 Requested job not found. X    
728 You are not allowed to see this job.     X
729 Invalid job TYPE, specify JOB, STC or TSU. X    
799 Entire System Server internal error.     X
830 JES interface is not active. X    
830 POWER interface is not active.   X  
988 Invalid task type detected.     X

Field Descriptions

Field Name Type/Length Operating System
ACCOUNT-NUMBER (A8) z/VSE, BS2000

Account number of user who submitted the job.

Field Name Type/Length Operating System
CARD-COUNT (N7) z/OS

Number of cards submitted to internal reader.

Field Name Type/Length Operating System
CLASS (A8) z/OS, z/VSE

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

Field Name Type/Length Operating System
COPIES (N3) z/VSE, BS2000

Number of copies of job.

Field Name Type/Length Operating System
CPU-MAX (N7.2) BS2000

CPU time limit for the job.

Field Name Type/Length Operating System
CPU-USED (N7.2) BS2000

CPU time already used by the job.

Field Name Type/Length Operating System
DATE-ON-READER (A8) z/OS

Date when job was submitted to the internal reader.

Field Name Type/Length Operating System
DATE-XEQ-START (A8) z/OS, z/VSE

Date when job or queue entry started executing.

Field Name Type/Length Operating System
DATE-XEQ-STOP (A8) z/OS, z/VSE

Date when job or queue entry finished executing.

Field Name Type/Length Operating System
DATX-XEQ-START (A8) z/OS, z/VSE

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

Field Name Type/Length Operating System
DATX-XEQ-STOP (A8) z/OS, z/VSE

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

Field Name Type/Length Operating System
DESTINATION (A8) z/OS, z/VSE

z/OS: JES destination of job.

z/VSE: POWER target user name.

Field Name Type/Length Operating System
DEVICE (A8) BS2000

Name of output device, if available.

Field Name Type/Length Operating System
DISP (A1) z/VSE

Job disposition. Possible values:

Value Explanation
*  Active
D  Delete.
K  Keep.
L  Leave.
Field Name Type/Length Operating System
FORM (A8) z/VSE

Form ID.

Field Name Type/Length Operating System
GROUP-ID (A20) z/OS

Unique identifier defined by JES.

Field Name Type/Length Operating System
HOLD (A3) z/OS, z/VSE, BS2000

YES indicates job is in hold.

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

Field Name Type/Length Operating System
JOB-CLASS (A1) z/OS

JES job class where the job is to be executed.

Field Name Type/Length Operating System
JOB-ID (A8) z/OS, z/VSE, BS2000

Job number or TSN of job in alphanumeric format.

Field Name Type/Length Operating System
JOB-NAME (A8) z/OS, z/VSE, BS2000

Name of the job.

Field Name Type/Length Operating System
JOB-NUMBER (N7) z/OS, z/VSE, BS2000

Job number assigned by JES (z/OS) or POWER (z/VSE).

Under BS2000, TSN of job.

Field Name Type/Length Operating System
MAX-RETURN-CODE (A10) z/OS

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 Operating System
MESSAGE-CLASS (A1) z/OS

Output message class.

Field Name Type/Length Operating System
ORIGIN (A8) z/OS, z/VSE

JES3 job origin.

Field Name Type/Length Operating System
ORIGINATOR-JOB-ID (A8) BS2000

For print jobs: alphanumeric TSN of task where print job was started.

Field Name Type/Length Operating System
ORIGINATOR-TSN (N5) BS2000

For print jobs: TSN of task which started the job.

Field Name Type/Length Operating System
OUTDISP (A6) z/OS

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

Field Name Type/Length Operating System
PAGE-COUNT (N5) z/VSE

Number of pages.

Field Name Type/Length Operating System
PROGRAMMER-NAME (A20) z/OS

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 Operating System
PRIORITY (N3) z/OS, z/VSE, BS2000

Priority of job.

Field Name Type/Length Operating System
QUEUE (A3) z/OS, z/VSE

Queue in which the job resides. Possible values:

z/OS IN Input queue.
NJE NJE receive/transmit queue.
OUT Output queue.
XEQ Job is executing.
z/VSE CRE Create queue.
LST List queue.
PUN Punch queue.
RDR Reader queue.
XMT Transmit queue.
Field Name Type/Length Operating System
REAL-RECORD-COUNT (N9) z/VSE

 Record count for segment or job (including control records).

Field Name Type/Length Operating System
RECORD-COUNT (N9) z/OS, z/VSE

Number of records in spool.

Field Name Type/Length Operating System
ROOM (A4) z/OS

Room number of user who submitted the job.

Field Name Type/Length Operating System
SEGMENT-NUMBER (N3) z/VSE

If the output is segmented, segment number of spool output.

Field Name Type/Length Operating System
SIZE (A6) BS2000

Size for print jobs in PAM pages.

Field Name Type/Length Operating System
SPOOL-UTILIZATION (B1) z/OS

Percentage of spool used.

Field Name Type/Length Operating System
STATUS (A9) z/OS, z/VSE, BS2000

In BS2000, task category.

In z/OS, z/VSE, status of job.

Possible values:

BS2000 BATCH Batch
DIALOG Dialogue
DO Dormant
TP Teleprocessing
WT Wait

For explanations and information on further parameters, see BS2000 documentation.

z/OS ACTIVE Job has been selected.
AVAILABLE Job is available.
WAITING Job is waiting (JES3 only).
z/VSE ACTIVE Job has been selected.
AVAILABLE Job is available.
CRE Job is in creation queue.
XMT Transmit queue.
Field Name Type/Length Operating System
SUBMITTER (A8) z/OS (JES3 only)

The submitting user ID of the job.

Field Name Type/Length Operating System
SYSTEM-ID (A4) z/OS, z/VSE

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

Field Name Type/Length Operating System
TIME-ON-READER (N6) z/OS

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

Field Name Type/Length Operating System
TIME-XEQ-START (N6) z/OS, z/VSE

Time of day when job or queue entry started executing.

Field Name Type/Length Operating System
TIME-XEQ-STOP (N6) z/OS, z/VSE

Time of day when job or queue entry finished executing.

Field Name Type/Length Operating System
TIMX-XEQ-START (N6) z/OS, z/VSE

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

Field Name Type/Length Operating System
TIMX-XEQ-STOP (N6) z/OS, z/VSE

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

Field Name Type/Length Operating System
TYPE (A3) z/OS

Type of job. Possible values:

Value Explanation
JOB  Batch job.
STC  Started task.
TSU  TSO user.
Field Name Type/Length Operating System
TYPE-NUMBER (N1) BS2000

Numeric job type identifier used in BS2000 (for example, 2 = batch, 3 = dialog).

Field Name Type/Length Operating System
USER (A8) z/VSE, z/OS, BS2000

Owner of the job. In BS2000, user ID of the job.

Field Name Type/Length Operating System
WLM-QUEUE-POSITION (N7) z/OS

Position on the WLM queue for the job.

Field Name Type/Length Operating System
WLM-SERVICE-CLASS (A8) z/OS

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.