Measure Reference Manual

LOCKWAIT-TIME
Time spent waiting for locks.
The REQUESTS-BLOCKED counter counts the number of blocked requests—that is, the number of
times requests are queued to locks. When the REPORT RATE value is on, this counter returns the
average wait time (LOCKWAIT-TIME divided by REQUESTS-BLOCKED).
Counter type: Lockwait.
MAX-LOCKWAIT-TIME
Maximum wait time per lock. This number can be used as a guide to set the timeout value in the
application. REPORT RATE ON has no effect on this counter value.
Counter type: Max value.
REQUESTS
Number of requests for this open.
Counter type: Incrementing.
REQUESTS-BLOCKED
Number of times an I/O operation had to wait because the requested file or record was locked.
Typically, a record lock is caused by a LOCKFILE request, a LOCKREC request, or a TMF auditing
operation.
Counter type: Incrementing.
SQL-OPERATION-TIME
DP2 process busy-time accumulated while DP2 was working on SQL subset requests on behalf of
this DISCOPEN.
Counter type: Busy.
Usage Notes for All DISCOPEN Entities
• The Measure subsystem tracks only local entities. Therefore, the DISCOPEN entity includes
I/O operations performed on local files only. Processes accessing the files can be local,
remote, or both, depending on the measurement configuration.
• The DISCOPEN counter record is attached to the open control block (OCB) entry for a disk
process. Because OCBs for backup disk processes are not measured, restart DISCOPEN
measurements if the primary disk process is disabled or moved.
• There are two forms of DDL record for the DISCOPEN entity: a short form and a long form.
The long record contains several additional counters that measure file locking. Not all file
opens require these measurements, so the MEASCTL process allocates the short or long record
at measurement time, based on the file type. The short record is allocated to temporary files
($vol.#nnnnnnn), edit files (file code 101), and object files (file code 100). The long record
format is allocated to all other file types.
The long record format is used for structured output files. If the data in the record is collected
with the short format, these counter fields contain zeros in the structured file:
LOCK-BOUNCESMAX-LOCKWAIT-TIMEREQUESTS
CACHE-WRITE-CLEANSLOCK-TIMEOUTSLOCKWAIT-TIME
DISCOPEN 215