Measure Reference Manual

Usage Notes for All USERDEF Entities
• To define a counter in an application, modify the source code to call the
MEASCOUNTERBUMPINIT and MEASCOUNTERBUMP procedures at appropriate times. For
descriptions, see MEASCOUNTERBUMP (page 387) and MEASCOUNTERBUMPINIT (page 388).
• To collect information from a user-defined counter, use the ADD USERDEF command to specify
the process that contains the user-defined counter and the ADD COUNTER command to specify
the name of the counter. For descriptions, see ADD USERDEF and ADD COUNTER under ADD
entity-type (page 41).
Usage Notes for H-Series and J-Series USERDEF Entities
• Several new counter types are defined for H-series and J-series RVUs.
Queue Busy. This counter type measures the amount of time during which the queue for
a resource is busy: that is the amount of time during which items were waiting on the
queue.
◦
◦ Busy, implemented with timer cells. This counter has the same semantics as a conventional
busy counter but uses the timer-cell mechanism to provide finer granularity timers.
◦ Queue, implemented with timer cells. This counter has the same semantics as a
conventional queue counter but uses the timer-cell mechanism to provide finer granularity
timers.
◦ Queue Busy, implemented with timer cells. This counter has the same semantics as a
conventional Queue Busy counter but uses the timer-cell mechanism to provide finer
granularity timers.
• If you define counters of the new types, Measure implicitly uses timer cells to maintain the
counters. For more information about using the timer cell mechanism, see Chapter 4: Measure
Callable Procedures (page 373).
Usage Notes for G-Series USERDEF Entities
• In Measure G07 and later PVUs, the USERDEF entity has a 64-bit accumulator counter type.
To add this new counter type, use the ADD COUNTER command with the keyword FACCUM.
• In Measure G11 and later PVUs:
◦ Customer applications can provide SUBSYSTEM-VERSION for ZMSUSER records if the
applications use the SUBSYSTEM-VERSION extension to the MEASCOUNTERBUMPINIT()
procedure.
◦ The USERDEF report distinguishes between ACCUM counters (32-Bit) and FACCUM
counters (64-bit). In the ZMSUSER report, all counters are formatted from 64-bit fields
and reported as type ACCUM.
372 Entities and Counters