lr.set_transaction

Creates a completed transaction.

C#

void lr.set_transaction( stringname, double duration, int status );

VB.NET

Sub lr.set_transaction( ByVal name As String, ByVal duration As Double, ByVal status As Integer )  
Example: lr.set_transactionTransaction Functions

Arguments

NameComments
NameA name for the transaction.
durationTransaction duration in seconds.
statusThe 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, 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: For information on allowed characters and maximum length for transaction names, see the transaction guidelines in the VuGen Help Center.

Return Values

No value returned.

Parameterization

All string input arguments can be passed using standard parameterization.