System::queryLockContentionStats Method

queryLockContentionStats(active:       Boolean output;
                         startingProc: Process output;
                         maxEntries:   Integer output;
                         startTime:    TimeStamp output);

The System class queryLockContentionStats method retrieves information about the current recording of lock contentions. A lock contention occurs when an attempt to lock a persistent object is queued or rejected because the object is already locked.

The information returned in the output parameters is listed in the following table.

Parameter Description
active Indicates if lock contention recording is currently active
startingProc A reference to the Process that initiated lock contention recording
maxEntries The maximum table size specified when lock contention recording was started, which determines the maximum number of individual objects that can have contentions recorded
startTime The time at which lock contention recording was started or restarted

The recording of lock contentions is under the control of the process that initiated the recording; that is, only that process can stop or restart recording of lock contentions. Although any process can use the queryLockContentionStats method, it should be assume that recording can stop or restart at any time, if it is not the process that started the recording.