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


Unlocks a MultiValue file.


FILEUNLOCK [filevar] [ON ERROR statements]


filevar Optional — A file variable name used to refer to a MultiValue file. This filevar is supplied by the OPEN statement. If not specified, the default file is unlocked.


The FILEUNLOCK statement is used to unlock a MultiValue file, undoing the lock established by FILELOCK. FILEUNLOCK only releases locks established by FILELOCK. It does not release record locks; record locks can be released using the RELEASE statement. You can check the status of file locks and record locks using the RECORDLOCKED function.

You can unlock a MultiValue file by issuing a FILEUNLOCK, by issuing a RELEASE with no record ID, or by closing the file.

FILEUNLOCK takes the file identifier filevar, defined by the OPEN statement.

You can optionally specify an ON ERROR clause. If file unlock fails, the ON ERROR clause is executed. This may occur if filevar does not refer to a currently open file. The statements argument can be the NULL placeholder keyword, a single statement, or a block of statements terminated by the END keyword. A block of statements has specific line break requirements: each statement must be on its own line; there must be a line break between the ON ERROR keyword and the first line.

See Also