tx_set_transaction_control - Set transaction

ANSI C, C++

#include <tx.h>
int  tx_set_transaction_control (TRANSACTION_CONTROL control)

K&R C

#include <tx.h>
int  tx_set_transaction_control (control)
TRANSACTION_CONTROL control

The function tx_set_transaction_control() sets the transaction_control characteristic to the value specified in control. This characteristic determines whether tx_commit() and tx_rollback() start a new transaction before returning to their caller.

The function tx_set_transaction_control() may be called regardless of whether the application program is in transaction mode. This setting remains in effect until changed by a subsequent call to tx_set_transaction_control().

The initial setting for this characteristic is TX_UNCHAINED.

<<control>>

The valid settings for control are as follows:

 
{TX_UNCHAINED|TX_CHAINED}

TX_UNCHAINED
This flag indicates that tx_commit() and tx_rollback() should not start a new transaction before returning to their caller. The caller must issue tx_begin() to start a new transaction.
TX_CHAINED
This flag indicates that tx_commit() and tx_rollback() should start a new transaction before returning to their caller.

<<When return value is 0>>: Upon successful completion, tx_set_transaction_control() returns TX_OK, a non-negative return value. <<The transaction_control characteristic was set to the value of control.>>

Errors

Under the following conditions, tx_set_transaction_control() does not change the setting of the transaction_control characteristic and returns one of these negative values.

Return value	Return value (numeric)	Explanation
TX_EINVAL	-8	The value set for control is neither TX_UNCHAINED nor TX_UNCHAINED.
TX_PROTOCOL_ERROR	-5	The function was called in an improper context (for example, the caller has not yet called tx_open()).
TX_FAIL	-7	The transaction manager encountered a fatal error. The nature of the error is such that the transaction manager can no longer perform work on behalf of the application.

<<if (tx_set_transaction_return (TX_UNCHAINED) == 0 &&
                                                tx_commit() < 0 )
  fputs ("cannot commit transaction\n", stderr);>>