TXSETTRANCTL - Set transaction_control characteristic

 DATA DIVISION.
*  Include TX definitions.
 01  TX-RETURN-STATUS.
     COPY  TXSTATUS.
*
 01  TX-INFO-AREA.
     COPY  TXINFDEF.
 
 PROCEDURE DIVISION.
 CALL "TXSETTRANCTL" USING TX-INFO-AREA TX-RETURN-STATUS.

TXSETTRANCTL sets the transaction_control characteristic to the value specified in TRANSACTION-CONTROL. This characteristic determines whether TXCOMMIT and TXROLLBACK start a new transaction before returning to their caller. TXSETTRANCTL 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 TXSETTRANCTL.

The initial setting for this characteristic is TX-UNCHAINED.

<<TRANSACTION-CONTROL>>

The valid settings for TRANSACTION-CONTROL are as follows:

TX-UNCHAINED
This flag indicates that TXCOMMIT and TXROLLBACK should not start a new transaction before returning to their caller. The caller must issue TXBEGIN to start a new transaction.
TX-CHAINED
This flag indicates that TXCOMMIT and TXROLLBACK should start a new transaction before returning to their caller.

Upon successful completion, TXSETTRANCTL sets TX-OK, a non-negative return value. <<0 is returned.>> <<The transaction_control characteristic was changed to the value of TRANSACTION-CONTROL.>>

Errors

Under the following conditions, TXSETTRANCTL does not change the setting of the transaction_control characteristic and sets one of these negative values;

TX-EINVAL: TRANSACTION-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 TXOPEN).

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.