CRE Programmer's Guide

CRE Service Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
6-21
CRE_File_Output_
file_ordinal
identifies the standard file to which to write. You can use the following symbolic
names for
file_ordinal:
buffer:write_count
is the record to transmit (buffer) and its length in bytes (write_count).
count_written
if present, is the number of bytes written when the record is transmitted. If a record
is not transmitted,
count_written is zero. See the following considerations for
more information on
count_written.
spacing_option
if present, specifies spacing actions. If you do not pass spacing_option,
CRE_File_Output_ uses a value of one.
spacing_option is applicable when the target device of CRE_File_Output_ is a
process, line printer, spooler collector, or terminal. The bits in
spacing_option
are defined as follows:
You can use
spacing_option.<4:15>, number of lines to advance, to obtain
particular effects. For example, a series of lines written with
spacing_option 2
creates double-spaced lines. A series of lines written with
spacing_option 0
creates overprinted lines.
Return Value
CRE_File_Output_ returns one of the following:
•
0 if the output operation is successful
•
A positive number, which is a file system error number
CRE File Ordinal Symbolic Names
CRE^Standard^Output
CRE^Standard^Log
Bits in
spacing_option Meaning
0 On this operation:
0: Write before advancing
1: Write after advancing
1 Default spacing mode:
0: Write before advancing
1: Write after advancing
2:3 Reserved
4:15 Number of lines to advance