Share this page

# lr.start_transaction

Marks the beginning of a transaction.

    int lr.start_transaction( String transaction_name );

Transaction Functions | Java Syntax

## Arguments

Name | Comments
--- | ---
transaction_name | The name of the transaction.

The lr.start_transaction function marks the beginning of a transaction. To indicate a transaction to be analyzed, use the lr.start_transaction and lr.end_transaction functions. These functions are inserted immediately before and after the transaction.

Transactions can be nested, but each lr.start_transaction statement must be associated with an lr.end_transaction statement or it will be interpreted as an illegal command.

Note: For information on allowed characters and maximum length for transaction names, see Transaction guidelines in the Virtual User Generator Help Center.

## Return Values

This function returns 0 if it succeeds. It returns -1 if the transaction name is illegal.

## Parameterization

Parameterization is not applicable to this function.

## Example

The sample below illustrates timing the duration of a method call getStockList from an ORB interface. It adds checks for exceptions and ensures that the getStockList method returns an non-zero length array.

Copy code

    lr.start_transaction("GetStocks");

    try {
        String stocks[];

        stocks = orStockServer1.getStockList();

        if (stocks.length == 0)
                throw new Exception("No stocks returned/available");

        lr.end_transaction("GetStocks", lr.PASS);

    }
    catch (Exception e1) {
        lr.end_transaction("GetStocks", lr.FAIL);
        lr.message(" An exception occurred : " + e1.toString() );
        }

Tips to improve your search results... VuGen Function Reference Version 26.1-26.3 Function Reference 26.1-26.3 All View Local Help Center View Online Help Center Version: