LIST-ITEM-LOCKS

Lists the current entries in the database Item Lock Table.

Syntax

LIST-ITEM-LOCKS {file-specifier item-id} {(options}

Syntax Elements

file-specifier specifies a file.

item-id is the name of the item whose lock you want listed.

Options

n Line number.  List the Item Locks set by line number n.

n - m Line number range.  List the Item Locks set by lines n through m inclusive.

I Item. List the lock number that a particular file produces.

P Print. Print the Item Lock Table.

S Suppress detail. List only the total number of Item Locks set.

Report Headings

Heading	Description
Port#	Port that set the lock.
CTX	Perform-context-level.
Lock	Item lock number.

Example 1

:LIST-ITEM-LOCKS

Port# CTX Lock............ Lock............ Lock............
  401   0 000195EF00002D11
  403   0 00B5D14F00002D11
  404   0 00DA53B700002D11 6A2AEFD000002D11
  405   1 2EA32C7800002D11
[973] 5 locks listed. 

Example 2

This example lists only the locks for ports in the range 401 to 403.

:LIST-ITEM-LOCKS (401-403

Port# CTX Lock............ Lock............ Lock............
  401   0 000195EF00002D11
  403   0 00B5D14F00002D11
[973] 2 locks listed. 

Example 3

This example uses the S option to suppress the details, listing only the number of locks.

:LIST-ITEM-LOCKS (S)

[973] 6 LOCKS LISTED