PURPOSE

tx_set_transaction_control - set transaction_control characteristic

SYNOPSIS


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

DESCRIPTION

tx_set_transaction_control() sets the transaction_control characteristic to the value specified in control. This characteristic determines whether tx_commit(3c) and tx_rollback(3c) start a new transaction before returning to their caller. 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.

Following are the valid settings for control.

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

RETURN VALUE

Upon successful completion, tx_set_transaction_control() returns TX_OK, a non-negative return value.

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:

[TX_EINVAL]: control is not one of TX_UNCHAINED or TX_CHAINED.
[TX_PROTOCOL_ERROR]: The function was called in an improper context (for example, the caller has not yet called tx_open(3c)).
[TX_FAIL]: 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. The exact nature of the error is written to a log file.

WARNINGS