HP WebQoS Software manual Using the External Measurement API

External Measurement API

Using the External Measurement API

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.

134 Appendix B