Utility Functions and C Language Reference > Utility Functions: C Language (lr_) > Alphabetical Listing > lr_user_data_point_instance

lr_user_data_point_instance

Records a user-defined data sample and correlates it to a transaction instance.

C Language

long lr_user_data_point_instance( char *sample_name, double value, long transaction_handle );
Example: lr_user_data_point_instance Informational Functions

Arguments

Name Comments
sample_name The data point name.
value The value to record.
parent_handle A transaction instance identifier with which to associate the data_point.

The lr_user_data_point_instance function is similar to lr_user_data_point except that lr_user_data_point_instance has a transaction_handle parameter. This parameter allows you to associate a data point with a specific transaction instance.

This function is intended for use with applications integrated with LoadRunner that use transaction instances.

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.

For details on transaction instances, see lr_start_transaction_instance.

Return Values

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

Parameterization

All string arguments (char type) can be parameterized using standard parameterization.