lr_user_data_point

Records a user-defined data sample.

C Language

int lr_user_data_point( char *sample_name, double value );

Example: lr_user_data_point

Informational Functions

Java Language

Int lr.user_data_point( String sample_name, Double value );

Example: lr.user_data_point

Informational Functions

Java Syntax

Arguments

Name	Comments
sample_name	The data point name.
value	The value to record.

The lr_user_data_point function allows you to record your own data for analysis. Each time you want to record a point, use this function to record the sample name and the value. The time of the sample is recorded automatically. After the execution, you can use the User Defined Data Points graph to analyze the results.

The following prefixes in sample_name are reserved:

HTTP
NON_HTTP
RETRY
mic_
stream_
mms_

A data point with any of these prefixes, for example "HTTP_BT", will not appear on the graph. However, the prefixes are case-sensitive, therefore "http_BT" is a valid sample_name.

Return Values

This function returns 0 if it succeeds, and -1 if it fails to write the sampled data.

Parameterization