getLockContentionInfo

getLockContentionInfo(obj:       Object;
                      lci:       LockContentionInfo input;
                      startTime: TimeStamp output);

The getLockContentionInfo method of the System class returns lock contention information for a single object specified by the obj parameter.

A lock contention occurs when an attempt to lock a persistent object is queued or rejected because the object is already locked. The information is copied into attributes of the LockContentionInfo instance specified by the lci parameter.

The calling process is responsible for creating and deleting the LockContentionInfo instance.

The startTime parameter is an output parameter that receives the date and time at which lock contention recording was started or restarted.

For details about the information available in LockContentionInfo instances, see "LockContentionInfo Class", in Chapter 4 of the JADE Object Manager Guide.

If there have been no lock contentions for the specified object, the values of the totalContentions, maxWaitTime, and totalWaitTime attributes are set to zero (0).

If this method is called when lock contentions are not being recorded, the startTime parameter and information in the LockContentionInfo instance are set to zero (0) values. The beginLockContentionStats and endLockContentionStats methods are used to control recording of lock contentions.