LIST-GROUP-LOCKS
Lists the current entries in the group (read/update) lock table.
Syntax
LIST-GROUP-LOCKS {file-specifier item-id} {(options}
Syntax Elements
file-specifier Specifies a file. See General Conventions for details.
item-id The name of the item whose lock you want listed.
Options
portNum Port number. Lists only the locks set by port number portNum.
startPort-endPort
Port number range. Lists only the locks set by ports startPort
through endPort inclusive.
P Print. Print the Read/Update Locks Table.
R Read lock. Lists Read Locks only.
S Suppress detail. Lists only the total number of Read/Update Locks set.
U Update lock. Lists Update Locks only.
Report Headings
|
Heading |
Description |
|---|---|
|
PORT# |
The number of the port that set the lock. |
|
FID |
The FID (Frame Identifier) of the group that is locked. If an R follows the FID, it is a read lock; if a U, it is an update lock. |
Comment
Notice how many locks are marked with a U. If there is a large number, this indicates that many users are updating accounts, which may slow access by other users.
Examples
Report the complete Read and Update Lock Table by line number.
:LIST-GROUP-LOCKS
PORT# FID.... FID.... FID.... FID.... FID.... FID....
09996 02AADAR
[973] 1 LOCKS LISTED
Report only Update Locks set by line 1.
:LIST-GROUP-LOCKS (U1
[973] 0 LOCKS LISTED
Report only Read Locks.
:LIST-GROUP-LOCKS (R)
PORT# FID.... FID.... FID.... FID.... FID.... FID....
09996 02AADAR
[973] 1 LOCKS LISTED
Report the lock for file LABELS and item SMITH.
:LIST-GROUP-LOCKS LABELS SMITH
[973] O LOCKS LISTED
Report the number of locks set but not the details.
:LIST-GROUP-LOCKS (S)
[973] 1 LOCKS LISTED