FORTRAN Reference Manual

Utility Routines
FORTRAN Reference Manual—528615-001
15-16
FORTRANSPOOLSTART Routine
FORTRANSPOOLSTART Routine
FORTRANSPOOLSTART provides level-2 and level-3 access to the HP spooler from a
FORTRAN program.
FORTRAN automatically provides level-3 spooling for a file directed to the spooler
when FORTRANSPOOLSTART is not used and PARAM SPOOLOUT 0 is not in effect.
unit-number
is an integer expression whose value is the FORTRAN unit number of the file to
spool. If the spool file is opened before FORTRANSPOOLSTART, your program
must not write to it until it calls FORTRANSPOOLSTART. If the file is not opened
before calling FORTRANSPOOLSTART, FORTRANSPOOLSTART will open it.
error-return
is an INTEGER*2 variable in which FORTRANSPOOLSTART returns zero if it
successfully opens the spooler, or a file system or SPOOLSTART error code if it
cannot open the spooler. For explanations of spooler errors, see the Guardian
Procedure Errors and Messages Manual and for explanations of file system
errors, see the Spooler Programmer’s Guide.
If you do not specify error-return and the error code is nonzero, your program
stops and an error message is sent to the home terminal.
options
is an integer expression whose value specifies which level of spooling you want. If
options is 0, level-1 or level-2 spooling is used for the spool file. If options is a
nonzero value, level-3 spooling is used for the spool file. The FORTRAN run-time
library allocates the buffer space for level-3 spooling unless you specify level-3-
buffer.
CALL FORTRANSPOOLSTART ( unit-number
[, [ error-return ]
[, [ options ]
[, [ level-3-buffer ]
[, [ location ]
[, [ form-name ]
[, [ report-name ]
[, [ number-of-copies ]
[, [ page-size ]
[, [ flags ]
[, [ owner ]
[, [ max-lines ]
[, [ max-pages ] ]]] ]]] ]]] ]]] )