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

lr_set_transaction_status

Sets the default end status of open transactions.

C Language

int lr_set_transaction_status( int status);
Example: lr_set_transaction_status Transaction Functions

Java Language

int lr.set_transaction_status( int status);
Example: lr.set_transaction_status Transaction Functions Java Syntax

Arguments

Name Comments
status One of the Transaction Status constants for pass, fail, or stop. The auto status is not applicable.

The lr_set_transaction_status function sets the status of those transactions currently open which have LR_AUTO in their lr_end_transaction statement.

A transaction's status is defined in the status parameter of lr_end_transaction. If this status is LR_AUTO, the value is automatically assigned. By default, this value is LR_PASS, signifying a successful transaction. lr_set_transaction_status changes this default value to status.

Return Values

This function returns 0 on success and a negative value on failure.

Parameterization

Parameterization is not applicable to this function.