FORTRAN Reference Manual

Utility Routines
FORTRAN Reference Manual—528615-001
15-11
FORTRAN_SPOOL_OPEN_ Routine
FORTRAN_SPOOL_OPEN_ Routine
FORTRAN_SPOOL_OPEN_ provides level-1, level-2, and level-3 access to the HP
spooler from a FORTRAN program. You can use FORTRAN_SPOOL_OPEN_ only in
programs that specify ENV COMMON.
FORTRAN attempts to use level-3 spooling for any file that opens a spooler collector if
PARAM BUFFERED-SPOOLING OFF is not in effect. Calling
FORTRAN_SPOOL_OPEN_ enables you to use any spooling level and also to set
specific spooler attributes for the file.
unit-number
is an integer expression whose value is the FORTRAN unit number of the file to
spool.
error-return
is an INTEGER*2 variable in which FORTRAN_SPOOL_OPEN_ returns an error
code.
If error-return is zero, FORTRAN_SPOOL_OPEN_ successfully opened the
file with the spooler attributes you specified.
If error-return is less than 10000, its value is a file system error code. For
information about file system errors, see the Guardian Procedure Errors and
Messages Manual . For information about errors returned by spooler procedures,
see the Spooler Programmer’s Guide.
If error-return is greater than 10000, its value is a FORTRAN run-time error
code to which the FORTRAN run-time library has added 10000. To determine the
actual error code, subtract 10000 from the value returned in error-return and
see Appendix G, Run-Time Diagnostic Messages.
CALL FORTRAN_SPOOL_OPEN_ ( unit-number
[, [ error-return ]
[, [ filename ]
[, [ filename-size ]
[, [ protect ]
[, [ mode ]
[, [ stackspec ]
[, [ spacecontrol ]
[, [ spooling-level ]
[, [ location ]
[, [ form-name ]
[, [ report-name ]
[, [ number-of-copies ]
[, [ page-size ]
[, [ flags ]
[, [ owner ]
[, [ max-lines ]
[, [ max-pages ] ]]] ]]] ]]] ]]] ]]] ]])