ttXactIdRollback
Description
Rolls back the transaction indicated by the transaction ID that is specified. The intended user of ttXactIdRollback
is the ttXactAdmin
utility. However, programs that want to have a thread with the power to roll back the work of other threads must ensure that those threads call the ttXactIdGet
built-in procedure before beginning work and put the results into a location known to the thread that wishes to roll back the transaction. (Refer to ttXactIdGet in Oracle TimesTen In-Memory Database
Reference.)
Required Privilege
ADMIN
Syntax
ttXactIdRollback (ttUtilHandle handle, const char* connStr,
const char* xactId)
Parameters
Parameter | Type | Description |
---|---|---|
|
|
Specifies the TimesTen utility library environment handle allocated using |
|
|
Specifies the connection string of the database, which contains the transaction to be rolled back. |
|
|
Indicates the transaction ID for the transaction to be rolled back. |
Example
This example rolls back a transaction with the ID 3.4567 in the database named payroll
.
char errBuff [256];
int rc;
unsigned int retCode;
ttUtilErrType retType;
ttUtilHandle utilHandle;
...
rc = ttXactIdRollback (utilHandle, "DSN=payroll", "3.4567");
if (rc == TTUTIL_SUCCESS)
printf ("Transaction ID successfully rolled back.\n");
else if (rc == TTUTIL_INVALID_HANDLE)
printf ("TimesTen utility library handle is invalid.\n");
else
while ((rc = ttUtilGetError (utilHandle, 0, &retCode,
&retType, errBuff, sizeof (errBuff), NULL)) != TTUTIL_NODATA)
{
...
}