Provide controlled access to files.

Syntax

Lock [#]fileNumber [ , recordNumber | { [ start ] To end } ]

Unlock [#]fileNumber [ , recordNumber | { [ start ] To end } ]

Elements

fileNumber

The number assigned to the file when you opened it.

In a random file, the number of the record that you want to lock or unlock. In a binary file, the byte that you want to lock or unlock. The first record in a random file is record number 1; the first byte in a binary file is byte number 1. LotusScript locks or unlocks only the specified record or byte.

In a sequential file, LotusScript locks or unlocks the whole file, regardless of value you specify for recordNumber.

In a random file, the range of record numbers you want to lock or unlock. In a binary file, the range of bytes that you want to lock or unlock. If you omit start, LotusScript locks records or bytes from the beginning of the file to the specified end position. In a sequential file, LotusScript locks or unlocks the whole file, regardless of the start and end values.

In Windows 3.1, you must run SHARE.EXE to enable the locking feature if you are using MS-DOS® version 3.1 or later. Earlier versions of MS-DOS do not support Lock and Unlock.

Always use Lock and Unlock statements in pairs whose elements— fileNumber, recordNumber, start, and end — match exactly. If you do not remove all locks, or if the elements do not match exactly, unpredictable results can occur.

Example
See Also

LotusScript Language Reference: I through L
CodeLock function
LOC function
LOF function
Open statement
Macintosh platform differences in LotusScript
UNIX platform differences in LotusScript
OS/400 platform differences in LotusScript

Glossary