Open topic with navigation
Records a user-defined data sample.
int lr_user_data_point( char *sample_name, double value );
|Example: lr_user_data_point||Informational Functions|
int lr.user_data_point( String sample_name, double value );
|Example: lr.user_data_point||Informational Functions||Java Syntax|
|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.
Caution: If there are too many unique data point names, the Controller may run out of memory. This can happen, for example, when the data point name is created with code or by using parameter evaluation, and a unique name is created each iteration.
The result during test run is a large number of graphs, each with a single data point. In a long test, these graphs can consume all available memory.
The following prefixes in sample_name are reserved:
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.
This function returns 0 if it succeeds, and -1 if it fails to write the sampled data.
All string arguments (char type) can be parameterized using standard parameterization.