tx_set_transaction_timeout
-set transaction_timeout
characteristic
#include <tx.h>
int tx_set_transaction_timeout(TRANSACTION_TIMEOUT timeout)
tx_set_transaction_timeout
() sets the transaction_timeout
characteristic to the value specified in timeout
. This value specifies the time period in which the transaction must complete before becoming susceptible to transaction timeout; that is, the interval between the AP calling tx_begin
(3) and tx_commit
(3) or tx_rollback
(3). tx_set_transaction_timeout
() may be called regardless of whether its caller is in transaction mode or not. If tx_set_transaction_timeout
() is called in transaction mode, the new timeout
value does not take effect until the next transaction.
The initial transaction_timeout
value is 0 (no timeout).
timeout
specifies the number of seconds allowed before the transaction becomes susceptible to transaction timeout. It may be set to any value up to the maximum value for a long
as defined by the system. A timeout
value of zero disables the timeout feature.
Upon successful completion, tx_set_transaction_timeout
() returns TX_OK
, a non-negative return value.
Under the following conditions, tx_set_transaction_timeout
() does not change the setting of the transaction_timeout
characteristic and returns one of these negative values:
TX_EINVAL
]
TX_PROTOCOL_ERROR
]
tx_open
(3).
TX_FAIL
]
tx_begin
(3), tx_commit
(3), tx_open
(3), tx_rollback
(3), tx_info
(3)
Both the X/Open TX interface and the X-Windows system defines the type XID. It is not possible to use both X-Windows calls and TX calls in the same file.