Measure User's Guide

Defining Custom Counters
Measure User’s Guide—520560-003
5-7
Considerations
type
is a counter type: ACCUM, BUSY, or QUEUE. The type depends on the bump
action the application uses to bump the counter. Specify type in the ADD
COUNTER command to allocate the proper amount of space for the counter.
If the application treats the specified user-defined counter as an array of counters,
specify n as the number of counters associated with the counter name.
To create a configuration that measures the BILLING application using the
TRANSACTIONS counter:
8+ ADD USERDEF BILLING
9+ ADD COUNTER TRANSACTIONS, PROCESS BILLING, ACCUM, ARRAY 2
Considerations
•
You must execute the ADD USERDEF command before its associated ADD
COUNTER command.
•
The process specification in the ADD COUNTER command must be identical to
the process specification in a previous ADD USERDEF command.
•
The process specification in the INFO COUNTER display does not reflect the
USERDEF processes in the measurement configuration. Therefore, to restore the
current configuration, you must save both the INFO USERDEF and INFO
COUNTER displays.
•
You cannot run concurrent measurements on an application containing
user-defined counters. There can be only one measurement per process running
the instrumented code. If you try to measure user-defined counters in an
application with active counters, MEASCOM displays an error message when you
next enter a LIST USERDEF command if ZERO-REPORTS is set to INCLUDE.
•
To measure an application, the executing process must be measured. Therefore, a
PROCESS entity is added automatically for any USERDEF entity in the
measurement configuration. In this example, Measure automatically adds the
PROCESS entity in the measurement data file. It is not part of the measurement
configuration.
12+ INFO MEASUREMENT DATA
Add measurement $WORK.PERF.DATA
From 8 Nov 1990, 14:49:27, To 8 Nov 2002, 14:50:03
Process 1 Entities 71 Words
Userdef 1 Entities 76 Words
-- Add Userdef $WORK.APPL.BILLING
-- Add counter TRANSACTIONS, process $WORK.APPL.BILLING,
accum, array 2
-- Add counter TIMEPER, process $WORK.APPL.BILLING, busy
-- Add counter WAITING, process $WORK.APPL.BILLING, queue
•
To examine the application information, use the LIST USERDEF or LISTACTIVE
USERDEF command. Each USERDEF report contains information about the