Lock Contention Information

Jade provides the LockContentionInfo class, which is a transient class used to record information about lock contentions (that is, when an attempt to lock a persistent object is queued or rejected because the object is already locked). When lock contention recording is started, lock contention information is recorded on the database server node.

Use the System class beginLockContentionStats, clearLockContentionStats, and endLockContentionStats methods to start and stop recording lock contentions and the System class getLockContentionStats and getLockContentionInfo methods to retrieve recorded lock contention information.

The properties defined in the LockContentionInfo class are summarized in the following table.

Property	Description
maxWaitTime	The longest time in milliseconds that any process spent queued waiting to obtain a lock on the object
totalContentions	The number of lock contentions recorded for the object
totalWaitTime	The total time in milliseconds that all processes spent queued waiting to obtain locks on the object

The method defined in the LockContentionInfo class is summarized in the following table.

Method	Description
target	Returns a reference to the object to which the lock contention information relates