Skip to main content

This is documentation for Caché & Ensemble.

For information on converting to InterSystems IRIS, see the InterSystems IRIS Adoption Guide and the InterSystems IRIS In-Place Conversion Guide, both available on the WRC Distributions page (login required).

Previous sectionNext section


Reads a record into a file buffer and applies an update lock.


F-UREAD fb itemId
F-U fb itemId


fb An integer specifying the file buffer.
itemId The item ID of the record to be read from the file buffer. itemId can be an integer, or a reference to a buffer or a select list that contains the item ID.


The F-UREAD PROC command reads a specified record from a file into the file buffer. The file must have been opened using the F-OPEN command, which assigned it a numbered fb file buffer.

If the requested record is locked by another process, F-UREAD waits until the lock becomes available.

F-UREAD applies an update lock on the record, preventing other users access to the record. This lock is released using the F-FREE command.

F-UREAD is a PQN command.

See Also