FORTRAN Reference Manual

Utility Routines
FORTRAN Reference Manual—528615-001
15-13
FORTRAN_SPOOL_OPEN_ Routine
spooling-level
specifies the spooling level to use for the file. You can specify the following values:
location
is a character expression whose value specifies the location for the spooler job.
location overrides the location components of filename. location requires 16
characters. If location is more than 16 characters, only the first 16 characters
are passed to the spooler. If location is less than 16 characters, the FORTRAN
run-time library adds blanks on the right side of location when it calls
SPOOLSTART. The spooler expects a two-part location name in the following
format:
LOCATION ( 1: 1) must be "#"
LOCATION ( 2: 8) group name
LOCATION ( 9: 16) destination name
The group and destination names can be any combination of letters, digits, and
blanks.
form-name
is a character expression whose value specifies the form name for the spooler job.
form-name requires 16 characters. If form-name is more than 16 characters,
only the first 16 characters are passed to the spooler. If form-name is less than 16
characters, the FORTRAN run-time library adds blanks on the right side of location
when it calls SPOOLSTART. The spooler accepts any combination of letters, digits,
and blanks.
report-name
is a character expression whose value specifies the report name for the spooler
job. report-name requires 16 characters. If report-name is more than 16
Spooling Level Effect
< -1 FORTRAN_SPOOL_OPEN_ returns error 10056
(error 56), invalid parameter.
-1 The file uses level-3 spooling if the FORTRAN
run-time library can obtain a buffer and PARAM
BUFFERED-SPOOLING OFF is not specified.
Otherwise, the file uses level-1 or level-2 spooling.
Specifying -1 has the same effect as omitting the
spooling-level parameter.
0 The file uses level-1 or level-2 spooling. The run-
time library does not allocate a buffer.
> 0 The file uses level-3—buffered—spooling. Your
program terminates or returns an error if the file
cannot use level-3 spooling—for example, if the
runtime library cannot allocate a buffer.