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

lr_start_transaction

Marks the beginning of a transaction.

C Language

int lr_start_transaction( char *transaction_name );
Example: lr_start_transaction Transaction Functions

Java Language

int lr.start_transaction( String transaction_name ); 
Example: lr.start_transaction 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: 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

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

Parameterization

Parameterization is not applicable to this function.