UniBasic Commands Reference - Rocket Software

1-903 UniBasic Commands Reference
If the NO.DUPS keyword was specified when the alternate key index was
created, UniBasic will not write a record that would create a duplicate index
key. Instead, the ON ERROR clause executes (or the program aborts if ON
ERROR is not coded) and the STATUS function returns a value of 10. RFS
does not support NO.DUPS.
Parameters
The following table describes each parameter of the syntax.
Parameter Description
expr Specifies an expression to write to the record.
ON | TO file.var Specifies a file to which to write the expression.
If you do not specify a file.var, UniData writes to the default file. If
no default file is open, a fatal error occurs.
A default file is one for which no file variable is assigned in the OPEN
statement.
record.ID.expr Specifies a record to receive the expression. If the record already
exists, the new expression you specify with expr replaces the existing
information. If the record you specify does not exist, UniData creates
the record.
ON ERROR
statements
Specifies statements to execute in the event of a fatal error condition
(such as the file is not open, an I/O error occurs in the write process,
or the record contains a duplicate alternate index key). If you do not
specify the ON ERROR clause, the program terminates under fatal
error conditions.
When including WRITE statements within a transaction, you must
code an ON ERROR clause that notifies the user and takes appropriate
action, such as stopping the transaction. If the transaction is not
aborted by the ON ERROR clause, processing continues, and the
transaction could commit inappropriately.
WRITE Parameters