Measure Reference Manual

2. Add the counter to the configuration by using the ADD COUNTER command. Identify
each process that modifies the counter by specifying an entity-spec exactly as specified
in the ADD USERDEF command.
• The record for user-defined counters can be up to 1000 words long. Each process can maintain
up to 85 named user-defined counters, and each counter can be an array of up to 128 counter
values, as long as the 1000-word limit is not exceeded. Each entity in an array is considered
a counter and counts against the 1000-word limit. If you have long counter arrays, a counter
record overflow is possible.
Each USERDEF entity is limited to 256 total array elements. To calculate the number of array
elements, add the number of elements in each array (ARRAY size) plus 1 for each array
defined. For example:
+ ADD COUNTER COUNTER1, PROCESS MEASTEST, ACCUM, ARRAY 20
+ ADD COUNTER COUNTER2, PROCESS MEASTEST, BUSY, ARRAY 20
The total number of array elements in this example is 42 (20 + 20 + 1 + 1). If the total number
of array elements exceeds 256, error 3251 (configuration error) is returned.
• More than one process can maintain a counter. However, you can measure only one set of
user-defined counters for a process. That is, if you start a measurement using a set of
user-defined counters in a process, you cannot start another measurement using a different
set of user-defined counters in that same process until the first measurement stops.
Example
This example adds two user-defined counters to the current configuration: TRANSACTIONS, an
accumulating counter, and WAITING, a busy counter. Both counters are modified by the BILLING
process.
+ ADD USERDEF BILLING
+ ADD COUNTER TRANSACTIONS, PROCESS BILLING, ACCUM
+ ADD COUNTER WAITING, PROCESS BILLING, BUSY
ADD MEASUREMENT
The ADD MEASUREMENT command makes a measurement data file accessible to MEASCOM,
so you can generate reports or plots from the data file. You must issue ADD MEASUREMENT before
using the LIST, LISTALL, or LISTACTIVE commands to display data.
ADD MEASUREMENT makes a data file accessible by creating a file-handling process (MEASFH)
for the file. The MEASFH process performs all I/O for that measurement data file. MEASFH is
created the first time you issue ADD MEASUREMENT for a file and remains active until you delete
access to the data file or end the Measure session.
Although you can access only one data file at a time, you need not delete access to a data file
before making a different file accessible. For example, you can issue an ADD MEASUREMENT
command for FILE1, display data from FILE1, then issue an ADD MEASUREMENT command for
FILE2. FILE2 becomes the currently accessible data file, and access to FILE1 is suspended (but not
deleted). This feature lets you move between data files without stopping and starting the associated
MEASFH processes.
Syntax
ADD [ MEASUREMENT ] data-file [ , MEASFH measfh ]
MEASUREMENT
is optional if you specified MEASUREMENT as the default command object by using the
ASSUME command.
ADD MEASUREMENT 45