TACL Reference Manual

Built-In Functions and Variables

HP NonStop TACL Reference Manual—429513-018

9-249

#LOCKINFO Built-In Function

Use #LOCKINFO to obtain information about record locks.

lock-spec

consists of a numeral followed by one or more descriptive fields, and specifies the type

of lock information wanted; lock-spec can be any of these:

0 device-name

searches the specified device for all locks.

1 file-name

searches the specified file for all locks.

2 device-name [\node-name.] {$process-name | cpu,pin }

searches the specified device for all locks set by the specified process.

3 device-name transid

searches the specified device for all locks under the specified transaction ID.

transid is a four-word transaction identifier that uniquely identifies a specific

transaction protected by the TMF subsystem. transid must have this format:

\node ( crash-count ). cpu. sequence-number

( crash-count ) can be omitted if it equals 0. \ node can specify a node

name or node number and can be omitted for a local node if crash-

count is also omitted.

tag

is a number identifying a specific set of lock information. If tag is zero, #LOCKINFO

obtains the first lock information. #LOCKINFO includes in its result the tag value

you need to get the next lock information in sequence.

buffer

is a variable level that is to receive the lock information; it must be a writable

STRUCT (see “Example” for a suggested structure definition). The minimum length

for buffer is 294 bytes.

Result

#LOCKINFO returns a file-system error code indicating the outcome of the operation. If

the code is 0 (no error) or 45 (file is full-no error otherwise), it is followed by a space

and the tag to be passed in the next call to #LOCKINFO.

#LOCKINFO lock-spec tag buffer