OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

lckls (Display lock information)

Format

lckls {[-a] [server-name]|[-r resource-name]}

Function

The lckls command outputs lock information to the standard output.

Options

-a

Specifies that occupancy and wait information about a lock resource is to be displayed.

When this option is omitted, only wait information is displayed.

-r resource-name

Specifies the resource whose occupancy and wait information is to be displayed. When you specify this option, OpenTP1 attempts to find a forward match for the specified character string (resource name) and displays the information about all the matching resources.

Command arguments

server-name~<identifier, 1-8 characters>

Specifies the name of a server for which information is to be output to the standard output. OpenTP1 attempts to find a forward match for the specified character string (user server name) and outputs the information about all the matching user servers to the standard output.

When this command argument is omitted, information about all user servers related to the lock information is displayed.

Output format

[Figure]

#1. and #2. are displayed on one line. If there are two or more pieces of lock or wait information, line 2. is displayed repeatedly by the number of the pieces.

aa...aa
Server name (up to 8 characters)

bbbbb
Process ID (decimal)

cc...cc
Resource name (1-16 characters)

ddd
Server ID (3 characters)

ee
Lock control mode (2 characters)
EX: Referencing or updating other UAPs is not permitted.
PR: Only referencing other UAPs is permitted.

fffffff
Request type (1-7 characters)
MIGRATE: TAM service lock request or user lock request
BRANCH: DAM service lock request

ggggg
Wait time (decimal, in seconds)
(***** is displayed for the occupancy information)

hhh
Deadlock priority value (decimal)

iii
Lock wait priority value (decimal)

Output messages

Message ID Description Output destination
KFCA00430-E lckls command cannot be executed. Standard error output
KFCA00431-I Help message Standard output,
standard error output
KFCA00433-E No lckls command execution environment has been set up. Standard error output
KFCA00434-E lckls command cannot be executed due to incompatible versions. Standard error output
KFCA00437-E lckls command format is invalid. Standard error output