TMM_ROLLBACK_TX Function

7.14.7.4 TMM_ROLLBACK_TX Function

Used by a transaction initiator application to roll back a global transaction.

Syntax

TMM_ROLLBACK_TX (
   microTxTransaction IN MicroTxTransaction,
   forwardHeaders     IN ForwardHeaders DEFAULT NULL
);

TMM_ROLLBACK_TX Function Parameters

Parameter Description

microTxTransaction Mandatory parameter. The MicroTxTransaction object that the TMM_BEGIN_TX function returns.

Parameter	Description
`microTxTransaction`	Mandatory parameter. The `MicroTxTransaction` object that the `TMM_BEGIN_TX` function returns.
`forwardHeaders`	Optional. The application forwards the specified headers to the MicroTx coordinator, and then the coordinator uses these headers while communicating with the application. An application can forward the following headers: authorization token, transaction token, and a unique ID to trace the transaction across the microservices. If you have enabled authorization by setting `tmmConfiguration.authorization.authTokenPropagationEnabled` to `true` in the `values.yaml` file for the coordinator, your application must forward the authorization token. If you have set `tmmConfiguration.transactionToken.transactionTokenEnabled` to `true` in the `values.yaml` file for the coordinator, your application must forward the transaction token.

forwardHeaders

Optional. The application forwards the specified headers to the MicroTx coordinator, and then the coordinator uses these headers while communicating with the application. An application can forward the following headers: authorization token, transaction token, and a unique ID to trace the transaction across the microservices.

If you have enabled authorization by setting tmmConfiguration.authorization.authTokenPropagationEnabled to true in the values.yaml file for the coordinator, your application must forward the authorization token.

If you have set tmmConfiguration.transactionToken.transactionTokenEnabled to true in the values.yaml file for the coordinator, your application must forward the transaction token.

Examples

The following sample code demonstrates how you can roll back a transaction using the TMM_ROLLBACK_TX function.

TMM_ROLLBACK_TX (l_microTxTransaction, l_forwardheaders);

Where, l_microTxTransaction is the name of the MicroTxTransaction object that the TMM_BEGIN_TX function returns and l_forwardheaders that the headers that the application forwards.

Parent topic: MicroTx PL/SQL Library Functions