Asynchronous Serial Communications Programmer's Reference Manual (32022-90052)

254 Chapter9
Intrinsics Reference (cont)
FWRITE
parameter is effective only for files opened with
carriage control (CCTL) specified in the FOPEN or
HPFOPEN call.
The controlcode parameter may contain 0, 1, or one of
the octal codes from Table 9-3. These options are used
to indicate carriage control action as follows:
0 Print the full record transferred, using
single spacing. This results in a
maximum of 132 characters per printed
line.
1 Use the first character of the data
written to satisfy space control and
suppress this character on the printed
output. The results are a maximum of
132 characters of data per printed line.
The values permissible for use as the
first character to specify control are the
same as the octal values described
below, and listed in Table 9-3.
When one of the octal codes listed in Table 9-3 is used
as the value of controlcode the carriage control action
associated with the specific code is applied to the data
being transferred. (You must have specified CCTL
through the FOPEN or HPFOPEN call, or through an
overriding :FILE command.) The full record
transferred is then printed, with a maximum of 132
characters per printed line.
If the file being written is not a spooled file, (that is, it is
not written to disk before being output to the device),
all of the octal codes listed in Table 9-3 can also be
passed through FCONTROL(1).
A carriage control directive passed through
FCONTROL(1) takes effect whether or not CCTL was
specified for the file.
For spooled files, however, carriage control must be set
using FWRITE. Additionally, the prespace/postspace
control normally set through FCONTROL must be set
through FWRITE for spooled files. You can use control
codes %100 through %103 and %400 through %403 for
this purpose.
If the controlcode parameter is not 0 or 1, and length
is 0, only the space control is executed and no data is
transferred.