Returns the lock status for a record or file.
||A file variable name used to refer to a MultiValue file. This filevar is supplied by the OPEN statement. filevar must be specified as a literal.
||The record ID of the record to be checked for lock status. An expression that resolves to an integer.
function returns an integer code specifying the lock status of the specified record or file. The following are the return codes:
||This user has a file lock (shared or exclusive).
||This user has an update record lock.
||This user has a shared record lock.
||This record is not locked.
||Another user has a shared record lock.
||Another user has an update record lock.
||Another user has a file lock (shared or exclusive).
If the specified file has both a file lock and a record lock, RECORDLOCKED
returns the record lock code.
Invoking the RECORDLOCKED
function sets the STATUS
function to the job number of the job that holds the lock. If the lock is a shared lock, STATUS
returns the job number of the first job found. If the current user shares the lock with another user, STATUS
returns the other user's job.
File and Record Locking and Unlocking
To lock a file, use the FILELOCK
statement. To unlock a file, use the FILEUNLOCK