Creates a completed transaction.
void lr.set_transaction( stringname, double duration, int status );
Sub lr.set_transaction( ByVal name As String, ByVal duration As Double, ByVal status As Integer )
|Example: lr.set_transaction||Transaction Functions|
|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, 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.