Utility Functions and C Language Reference > Utility Functions: Java (lr.) > Alphabetical Listing > lr_set_transaction


Creates a completed transaction.

C Language

int lr_set_transaction( const char *name, double duration, int status );
Example: lr_set_transaction Transaction Functions

Java Language

int lr.set_transaction( String name, double duration, int status);
Example: lr.set_transaction Transaction Functions Java Syntax


Name Comments
Name A name for the transaction.
duration Transaction duration in seconds.
status The transaction completion status. One of the Transaction Status constants for pass, fail, or stop. The auto status is not applicable.

The lr_set_transaction function creates a transaction, its duration, and status in a single call. Use it where the business process you want to capture in a transaction does not consist of sequential steps, or where you may or may not want to create a transaction, depending on conditions that are known only during the test.

To create a transaction for non-sequential steps, capture the duration of each series of steps that participate in the business process. Sum the durations and create the transaction with lr_set_transaction.

To capture durations in C language scripts, use lr_start_timer and lr_end_timer. For other languages, use the native language time functions.

lr_set_transaction can also be used to report the duration of a failed transaction by saving the duration before the transaction fails with lr_get_transaction_duration then using lr_set_transaction to create a new transaction for reporting that time.

lr_set_transaction creates and closes the transaction. Therefore, no functions that work only on open transactions are applicable.

Note: Do not use the period character (.) in a transaction name. The period character delimits transactions and sub-transactions. In analysis, a transaction name with a period will be interpreted as two transactions.

Return Values

This function returns LR_PASS (0) on success, and LR_FAIL (1) on failure. Note that in many cases, this return value indicates the technical success of the function, and not the result. For example, a function that registers a string to be found in a subsequent step returns LR_PASS to indicate that the registration was successful. This does not indicate that the string was found in the server response.


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