UniBasic Commands Reference - Rocket Software

Writing to Other Types of Files
For files that are not named pipes, processing is determined by the presence or
absence of the AT clause:
1-551 UniBasic Commands Reference
AT clause specified – UniBasic begins writing to the file at the offset
specified by byte.expr.
AT clause not specified – UniBasic begins writing to the current location of
the file pointer.
After successful execution of OSBWRITE against a file that is not a named
pipe, the file pointer remains at the next byte after the data is written.
Parameters
The following table describes each parameter of the syntax.
Parameter Description
expr Specifies the expression to write to the file.
ON | TO file.var Specifies the file on which to write the expression.
AT byte.expr If byte.expr is 0, the write begins at the beginning of the file.
NODELAY Forces an immediate write.
Include NODELAY to write to a named pipe immediately
regardless of whether the pipe contains data. If you do not
specify NODELAY, the process attempting to write waits until
the pipe is opened for reading.
ON ERROR statements Specifies statements to execute if the OSBWRITE statement
fails with a fatal error because the file is not open, an I/O error
occurs, or UniData cannot find the file.
If you do not specify the ON ERROR clause and a fatal error
occurs, the program terminates.
OSBWRITE Parameters