Transaction control

When an XATMI service is called, the client uses the call parameter flag (in C) or the TPTRAN-FLAG (in COBOL) to specify whether or not a called UTM service is included in the global transaction.
The XATMI-C interface includes the service in the global transaction by default. In order to exclude the service from the global transaction, you must set the TPNOTRAN flag explicitly. No default value exists for the XATMI-COBOL interface, you must set either TPTRAN or TPNOTRAN.

If the service is started with the TPTRAN flag, then it is included in the global transaction.

When using the tpreturn() call, the parameter rval returns the values TPSUCCESS or TPFAIL. This determines whether the transaction is terminated successfully or rolled back.

When using the XATMI interface with the UPIC carrier system the TPTRAN flag is ignored and the TPNOTRAN flag set internally. This behaviour improves the portability of XATMI programs.