Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (W-Z)
Guardian Procedure Calls Reference Manual—522629-013
16-14
WRITE^FILE Procedure
111 Operation aborted because of BREAK (if BREAK is enabled)
If
nowait is not 0, the only possible value for error is 0, when abort-on-error
mode is in effect.
file-fcb input
INT:ref:*
identifies the file to which data is written.
buffer input
INT:ref:*
is the data to be written.
buffer must be located within
‘G’[ 0:32767 ], the process data area.
write-count input
INT:value
is the count of the number of bytes of
buffer to be written. A write-count
value of -1 causes SIO to flush the block buffer associated with the
file-fcb
passed.
reply-error-code input
INT:value
(for $RECEIVE file only) if present, is a file-system error to return to the requesting
process by REPLY. If omitted, 0 is returned.
forms-control-code input
INT:value
(optional) indicates a forms-control operation to be performed prior to executing the
actual WRITE when the file is a process or a line printer. The
forms-control
paramater corresponds to
parameter of the file-system CONTROL procedure for
operation equal to 1. No forms control is performed if forms-control is
omitted, if it is -1, or if the file is not a process or a line printer.
nowait input
INT:value
if present, indicates whether to wait in this call for the I/O to complete. If omitted or
zero, then wait is indicated. If
nowait is not zero, the I/O must be completed in a
call to WAIT^FILE.