LockContentionInfo Class

The transient LockContentionInfo class is used to return 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

For details about:

The LockContentionInfo class, see Volume 2 of the JADE Encyclopaedia of Classes
Locking, see Chapter 6 of the JADE Developer’s Reference