UniBasic Commands Reference - Rocket Software

WRITE
Syntax
WRITE expr {ON | TO} [file.var,] record.ID.expr [ON ERROR statements]
Description
The UniBasic WRITE command writes an expression to an opened file and releases
locks set by the same process.
Note: WRITE updates the record and releases UniData locks regardless of lock
status. To check for and retain record locks, use the WRITEU command. For more
information, see Developing UniBasic Applications.
To maintain file integrity, UniData locks records with a nonprogrammable lock
during a write. UniData releases this lock immediately after the WRITE command
executes.
Warning: Do not use UniBasic READ and WRITE commands to open or modify
binary data in DIR-type files (for example, BP). Doing so can corrupt data in the file.
Instead, use OSREAD or OSBREAD after executing the UniBasic NOCONVERT
command.
Updating Alternate Key Indexes
Remember the following points about alternate key indexes when you code WRITE
statements:
Alternate key indexes that are currently enabled are automatically updated
when you write a record.
If you execute the ECL command DUP.STATUS ON, and then write a
record that creates a duplicate alternate key, WRITE sets the STATUS return
value to 10.
WRITE 1-902