Utility Functions and C Language Reference > Utility Functions: C Language (lr_) > Alphabetical Listing > lr_get_transaction_status

lr_get_transaction_status

Returns the current status of a transaction.

C Language

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

Arguments

Name Comments
transaction_name The name of the transaction.

lr_get_transaction_status returns the current status of a transaction. lr_get_transaction_status cannot be invoked after lr_end_transaction. Since lr_get_transaction_status can only return the status of an open transaction, it cannot report the final transaction status.

This function can be useful when a transaction that is made up of a number of steps can fail at various points. By checking the status and terminating the Vuser, you can prevent unnecessary activity.

Note: If "Continue on Error" is not set, the transaction may fail on an error. If a lr_get_transaction_status step is after the point where the error occurs, the transaction flow will stop at the error and the step will not be reached.

Return Values

Returns the transaction status or a negative number on error. See Transaction Status

Parameterization

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