GETLOCKS()

The GETLOCKS() function returns information about file and record locks.

Format

GETLOCKS(file, user)

where

file	is the file variable referencing the file for which locks are to be reported. All files are reported if this is not a valid file variable.

user	is the user number for which locks are to be reported. All users are reported if this is zero.

The GETLOCKS() function returns a string where field 1 contains three values:

1 NUMLOCKS configuration parameter value

2 Current record lock count

3 Peak number of record locks

and the remaining fields each describe a record or file lock as seven values:

1 Internal file number

2 Pathname

3 User number

4 Lock type as below

5 Record id, null for a file lock

6 User name of lock owner

7 Time as an epoch value when the lock was acquired or a blocked process started waiting

The lock type code is:

FX	File exclusive lock

RL	Shareable read lock (READL)

RU	Exclusive read lock (READU)

SX	File lock for CLEARFILE

WAIT	Process is waiting for the lock

Example

LOCK.INFO = GETLOCKS(0, 0)

This statement returns lock information for all files and all users.