Measure User's Guide

Measure User’s Guide—520560-003
6-1
6
Creating a Custom Measurement
Application
You can write application programs that control the Measure subsystem and access
measurement data. Your application must pass calls to the Measure procedures, which
provide a programmatic equivalent of the MEASCOM command functions.
For example, you can design custom performance tools that:
•
Perform specialized analyses of Measure data
•
Continuously collect selected performance information and present it for problem
analysis and correction
•
Dynamically balance the load on CPUs by monitoring the CPUs and creating new
processes on those least loaded
•
Collect capacity-planning information, analyze it, produce reports, and flag critical
performance problems
This section describes how to use the callable procedures to:
•
Start and stop the Measure subsystem
•
Start and stop a measurement
•
Read counter records from a data file and from active counters
•
Check the status of the subsystem, a measurement, and a measurement
configuration
Table 6-1 on page 6-2 lists the callable procedures. For more information, see the
Measure Reference Manual.
Preparing Your Program and Defining the
Configuration
Preparing your program is a four-step process:
1. Read declaration files into the source code global declarations.
2. Allocate space in your program’s global data area for the Measure control block.
3. Define the entities to be measured.
4. Declare and initialize the records of the configuration table.