Spooler Programmer's Guide

Spooler Procedure Calls
Spooler Programmer’s Guide—522287-002
4-60
SPOOLJOBNUM Procedure
SPOOLJOBNUM Procedure
The SPOOLJOBNUM procedure returns the job number of the job currently being
spooled to the collector. This procedure can be used when spooling at level 1, 2, or 3.
error-code returned value
INT
returns one of the following spooler error codes:
filenum-of-collector input
INT:value
is the file number of the collector. The file number is returned when the collector is
opened.
job-num output
INT:ref:1
is the job number of the job currently being spooled to the collector through the
specified file number. The value -1 is returned to job-num when filenum-of-
collector is a spooler job file.
Considerations
The following considerations apply to the use of this procedure:

A call to SPOOLJOBNUM can be issued by an application spooling at any level.

SPOOLJOBNUM cannot be called with nowait I/O.

When spooling at level 1, a job is not created until after the WRITE[X], SETMODE,
or CONTROL procedure is called once.

When spooling at level 2 or 3, a job is not created until after the SPOOLSTART
procedure is called.
error-code := SPOOLJOBNUM ( filenum-of-collector ! i
,job-num ); ! o
0 Successful operation
%1000-%1377 Error on file to collector (bits <8:15> contain a file-system error
number; see Considerations
on page 4-60)
%10000 Missing parameter
%11001 Attempted to write to the collector without first opening the file