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

lr_get_trans_instance_wasted_time

Returns the wasted time of a transaction instance.

C Language

double lr_get_trans_instance_wasted_time (long trans_handle);
Example: lr_get_trans_instance_wasted_time Transaction Functions

Arguments

Name Comments
trans_handle A transaction handle.

The lr_get_trans_instance_wasted_time function returns the Wasted Time of the specified transaction until this point.

The difference between this function and lr_get_transaction_wasted_time is that with this function you specify a transaction instance by its handle. With lr_get_transaction_wasted_time, you specify an independent transaction by its name.

The trans_handle is the handle returned by the call to lr_start_transaction_instance that created the instance.

The lr_get_trans_instance_think_time function returns values greater than zero only for open transactions.

To determine other transaction statistics, such as think time and wasted time, use the appropriate Transaction Functions.

Return Values

If this function succeeds, it returns the transaction wasted time in seconds. If it fails, it returns a negative number. If the transaction already ended or if data is not available for the specified transaction, it returns 0.

Parameterization

You cannot use standard parameterization for any arguments in this function.