Utility Functions and C Language Reference > Utility Functions: Scripting Languages (lr.) > Alphabetical Listing > lr.start_transaction


Marks the beginning of a transaction.


function lr.start_transaction(  transaction_name  )


Function lr.start_transaction(  transaction_name  )
Example: Transaction Duration, set_transaction, and waste time Transaction Functions


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: Do not use the period character (.) in a transaction or sub-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

On success, returns 0. Returns -1 if the transaction name is illegal.


Standard parameterization is not available for this function.