Performance Metric kcml.native.lock

Summary

Native file lock

Send Condition

$OPEN

Overview

Reports the status of a native file lock using $OPEN. The time taken to obtain the lock and the owner, if locked by another partition, can be used to identify the impact of application code that is enforcing exclusive access.

Statistics

Name	Type	Description
file	string	File name
handle	num	File handle
device	string	$DEVICE address
waittime	num	Number of micro-seconds spent waiting for the lock
locked	num	Did the lock succeed
ownerpid	num	Process ID of the lock owner
ownerpart	num	Partition number of the lock owner
owneruuid	string	UUID of the lock owner. Blank if $PSTAT is not wide enough

Config

Name	Description
lockwaitalert	If a lock takes longer than this timeout (in seconds) then issue a kcml.native.lock

General Form

kcml.native.lock,file=string,handle=num,device=string,waittime=num,locked=num,ownerpid=num,ownerpart=num,owneruuid=string