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

lr_end_sub_transaction

Marks the end of a sub-transaction.

C Language

int lr_end_sub_transaction( char *sub_transaction, int status );
Example: lr_end_sub_transaction Transaction Functions

Java Language

int lr.end_sub_transaction( String sub_transaction, int status );
Example: lr.start_sub_transaction and lr.end_sub_transaction Transaction Functions Java Syntax

Arguments

Name Comments
sub_transaction A string indicating the name of an existing sub-transaction.
status The transaction status.

The lr_end_sub_transaction function marks the end of a sub-transaction. To mark the beginning of the sub-transaction, use the lr_start_sub_transaction function. You insert these functions immediately before and after the sub-transaction steps.

Multiple sub-transactions can be nested within a parent transaction, but each lr_end_sub_transaction statement must match an lr_start_sub_transaction statement or it will be interpreted as an illegal command.

Return Values

This function returns 0 if it succeeds. It returns -1 if the transaction name is illegal or if there is no prior call to lr_start_transaction with a transaction of the same name.

Parameterization

You cannot use standard parameterization for any arguments in this function.