Measure Reference Manual

Lockwait Counters
Lockwait counters measure the time spent waiting for file locks. The lockwait counter is a special
case of a response time counter where the transaction is a lock.
Units Displayed As...Output Value Is...Attribute Setting
ms, sec, hr, day, or wkAverage lock time for each transaction.REPORT RATE is ON.
ms, sec, hr, day, or wkLock time.REPORT RATE is OFF.
Lock time, expressed in microseconds.REPORT FORMAT is STRUCTURED.
For an example of a lockwait counter, see the DISCOPEN entity counter LOCKWAIT-TIME (page 215).
Sampling Counters
Sampling counters measure the approximate busy time for PROCESSH code ranges. At random
time intervals, the Measure subsystem activates a sampling interrupt that examines the interrupted
process. If the process is under PROCESSH measurement, the sampling procedure increments the
process-busy-samples counter, increments the code-space-busy-samples counter if a measured code
space is busy, and increments the appropriate code-range-busy-samples counter.
Units Displayed As...Output Value Is...Attribute Setting
percentage of total samples for
the code space
Percent of sampling interrupts that found the
measured code space executing.
REPORT RATE is ON.
#, K, M, G, or TNumber of sampling interrupts that found the
measured code executing.
REPORT RATE is OFF.
percentage of total samples for
the code space
Percent of sampling interrupts that found the
measured code space executing.
REPORT RATE is ON.
Number of sampling interrupts that found the
measured code executing.
REPORT FORMAT is STRUCTURED.
For an example of a sampling counter, see the PROCESSH entity counter PROCESS-BUSY-SAMPLES
(page 321).
Snapshot Counters
Snapshot counters return a measurement value taken at a specific moment, such as at the start or
end of a measurement. No computation is done on the returned value; it is simply reported. Report
format options do not affect snapshot counters.
Snapshot counters are not affected by setting RATE ON or OFF. Units are displayed as #, K, M,
G, or T.
For examples of snapshot counters, see the DISC entity counters STARTING-FREE-SPACE and
ENDING-FREE-SPACE (page 199).
142 Entities and Counters