HP WebQoS Administration Guide

External Measurement API
Using the External Measurement API
Appendix B134
Using the External Measurement API
In Windows and Solaris, you must install the WebQoS API component.
The API allows you to send measurements to a customizable service level
SLO. The SLO is: Ensure <Measurement> is <CONDITION> <NUMBER> .
It is configured in the service template using the management console
(refer to the online help for more information about this SLO).
To use the API, do the following:
1. Choose a unique measurement name. The name you use in your
program must match the name you use in the service level SLO. If
you are configuring more than one SLO based on different
measurements, make sure you choose unique measurement names.
2. Write your program. Note the following:
• Include the following header file in your program:
In UNIX, the header file is
/opt/webqos/include/qosExternMeasApi.h
In Windows, the header file is
<install-directory> \include\qosExternMeasApi.h
• Call the following three methods in this order
(wqSendMeasurement() can be called multiple times within a
single wqCreateConnection() and wqCloseConnection()
pairing):
a. wqCreateConnection()
b. wqSendMeasurement()
c. wqCloseConnection()
• Link to the following library when compiling your program:
In UNIX, link to the file
/opt/webqos/lib/libqosExternMeasApi.sl
In Windows, link to the file
<install-directory> \lib\hpqosExternMeasApi.lib
3. Define the service level SLO in the service template using the
management console.