Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.

For information on migrating to InterSystems IRIS, see Why Migrate to InterSystems IRIS?


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