Open topic with navigation
Records a user-defined data sample and correlates it to a transaction instance.
long lr_user_data_point_instance( char *sample_name, double value, long transaction_handle );
|Example: lr_user_data_point_instance||Informational Functions|
|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.
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.