lr_get_trans_instance_think_time

Returns the think time of a transaction instance specified by its handle.

double lr_get_trans_instance_think_time (long trans_handle);

Arguments

The lr_get_trans_instance_think_time function returns the think time of the specified transaction until this point.

The difference between this function and lr_get_transaction_think_time is that with this function you specify a transaction instance by its handle. With lr_get_transaction_think_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 think time. 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.

Example

In the following example, the lr_get_trans_instance_think_time function gets the think time of a transaction instance, and sends it to the Output window.

long child_handle;
double trans_time; 
int rc; 

/* Start the main transaction instance. Passing 0 as the parent handle indicates that the 
    transaction has no parent. The function return value is the handle used in other 
    transaction instance functions. */ 

    child_handle = lr_start_transaction_instance("ParentTransaction",0); 

    /*Perform the business process, represented here with a single web_url call. */ 
    web_url("web_url", "URL=http://www.ABC.com",LAST ); 

// Get the transaction instance time.
    trans_time = lr_get_trans_instance_think_time(child_handle); 
    lr_output_message 
    ("Instance think time is %lf seconds.", trans_time);