OpenTP1 Version 7 Programming Reference COBOL Language
TXSETTRANCTL - Set transaction_control characteristic
Format
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. |
Description
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.
<<Data areas>>
<<TRANSACTION-CONTROL>>
The valid settings for TRANSACTION-CONTROL are as follows:
Return value
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;
See also
TXBEGIN, TXCOMMIT, TXOPEN, TXROLLBACK, TXINFORM.
<<Notes on use with Open TP1>>
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.