CRE Programmer's Guide

CRE Service Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
6-27
CRE_Spool_Start_
CRE_Spool_Start_
The CRE_Spool_Start_ function invokes the SPOOLSTART system procedure.
file_ordinal
identifies the standard file for which to initiate SPOOLSTART. You can use the
following symbolic names for
file_ordinal:
CRE^Standard^Output
CRE^Standard^Log
buffering
if present, specifies the buffering attribute for the spooler job; if buffering is not
passed, CRE_Spool_Start_ uses 0. You can use the symbolic names in the
following table to specify
buffering:
CRE^Simple^spooling
CRE^Buffered^spooling
CRE^Undecided^spooling
The preceding literals are defined in the CREDECS file for the TNS CRE, and the
CRERDECS file for the TNS/R or TNS/E native CRE. Refer to Section 3,
Compiling and Binding Programs for the TNS CRE, for information on the
CREDECS file. Refer to Section 4, Compiling and Linking Programs for the Native
CRE, for information on the CRERDECS file.
Figure 6-3
on page 6-30 shows the algorithm CRE_Spool_Start_ uses to choose
simple spooling or buffered spooling for the file associated with
file_ordinal.
INT PROC CRE_Spool_Start_(file_ordinal, buffering,
location:loc_bytes,
form_name:form_bytes,
report_name:report_bytes,
number_of_copies, page_size,
flags, owner, max_lines,max_pages)
EXTENSIBLE;
INT file_ordinal; ! in, required
INT buffering; ! in, optional
STRING .EXT location; ! in, optional
INT loc_bytes; ! in, optional
STRING .EXT form_name; ! in, optional
INT form_bytes; ! in, optional
STRING .EXT report_name; ! in, optional
INT report_bytes; ! in, optional
INT number_of_copies; ! in, optional
INT page_size; ! in, optional
INT flags; ! in, optional
INT owner; ! in, optional
INT(32) max_lines; ! in, optional
INT(32) max_pages; ! in, optional TNS, native