Availability Guide for Application Design

Instrumenting an Application for Availability
Availability Guide for Application Design—525637-004
8-39
User-Written Management Applications
3. Send the command to the subsystem using regular Guardian interprocess
communication.
4. Retrieve the response returned by the subsystem from the SPI message buffer
and use SPI procedures to extract the tokens.
Using SPI to Retrieve Events From an EMS Consumer
Distributor
To retrieve events from a consumer distributor, your management application must:
1. Start and establish a connection with a consumer distributor.
2. Set distributor attributes, such as which filter to use and which collector the
distributor should retrieve events from. To set these attributes you use SPI
procedures to build a command that you send to the distributor using regular
Guardian interprocess communication. The distributor acknowledges the request in
its response.
Two types of commands can be used to perform this kind of operation: one that
conforms to the SPI common extensions, and the original SPI distributor
CONTROL command. For a discussion on SPI common extensions, refer to the
SPI Common Extensions Manual.
3. Request an event message from the distributor. To do this, you again use SPI
procedures to build an EMS GETEVENT command and send the command to the
distributor using regular Guardian interprocess communication. The distributor
reads the command and returns the event message as a token in the GETEVENT
response.
4. Extract the event message, itself a token in the GETEVENT response, with the SPI
procedures.
5. Extract individual tokens from the event using the EMS procedures.
Using Measure to Gather System and Application
Performance Statistics
Any management application can use the Measure product to gather counts of
resource usage. To do so, you must use Measure procedures to interpret the counter
values generated by your application or by an HP subsystem. Your management
application must use these procedures to identify the process to be measured, the
counters you are interested in, and when to start and stop the measurement.
Note that you can also gather Measure statistics using the Measure program itself or
through the Surveyor product. In addition, you can perform analyses on Measure data
using the Enform product or the Guardian Performance Analyzer (GPA).
For complete details on how to use Measure to gather statistics about your application,
refer to the Measure User’s Guide.