Documentation Comments

Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.

Reality V15.0 ()

LIST-GROUP-LOCKS command (m605006+listgrouplocks.htm)

To	Reality
Version
Topic
Submitted by
Company
Location
Email address
Comment

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