commit the current transaction
#include <atmi.h>
int tpcommit(long flags);
tpcommit() ends the caller's transaction with a commit. With no resource managers this is bookkeeping; with participants it runs two-phase commit, and the error table below shows how the exotic outcomes surface (TPEHAZARD, TPEHEURISTIC). After the call the caller is no longer in transaction mode, and a tpreturn(TPSUCCESS) inside a service commits implicitly the same way.
| Argument | Description |
|---|---|
| flags | 0, or TPNOBLOCK/TPNOTIME/TPSIGRSTRT for the wait disposition. |
| Flag | Description |
|---|---|
| TPNOBLOCK, TPNOTIME, TPSIGRSTRT | Wait disposition for the commit. |
| Code | Description |
|---|---|
| TPEABORT | The transaction was rolled back instead; reported when commit could not complete. |
| TPEHAZARD | Commit outcome is uncertain; manual reconciliation may be needed. |
| TPEHEURISTIC | A participant resolved heuristically. |
| TPEPROTO | Not in transaction mode. |
| TPETIME | The commit wait timed out. |
| TPESYSTEM, TPEOS | Platform failure. |
Return value. Returns 1 on success, -1 on
error, on the platform and in fuxedo. Check == -1, not
truthiness: if (tpbegin(...)) treats a successful begin
as failure.
Full source: docs/api/examples/txdemo.c
(build and run with make -C docs/api/examples check
TUXDIR=<install>); the lines documenting tpcommit() are highlighted.
// Transaction demarcation examples: tpbegin/tpgetlev/tpsuspend/
// tpresume/tpcommit/tpabort in a client. No resource manager is
// involved, so the transaction has no participants and the commit is
// trivial on any platform.
#include <stdio.h>
#include <atmi.h>
static int fail(const char *what) {
fprintf(stderr, "%s failed: %s (%d)\n", what, tpstrerror(tperrno),
tperrno);
return 1;
}
int main(void) {
// tpbegin starts a transaction; the argument is the timeout in
// seconds (0 selects the platform default)
if (tpbegin(30, 0) == -1) {
return fail("tpbegin");
}
// tpgetlev answers whether the caller is in transaction mode:
// TP_IN_TRANSACTION or TP_NOT_IN_TRANSACTION
int lev = tpgetlev();
printf("after begin: %d\n", lev);
// tpsuspend stashes the transaction in a TPTRANID so the thread can
// leave transaction mode (another thread resumes it, or the same
// thread resumes it later)
TPTRANID tranid;
if (tpsuspend(&tranid, 0) == -1) {
return fail("tpsuspend");
}
printf("after suspend: %d\n", tpgetlev());
// tpresume re-enters the stashed transaction
if (tpresume(&tranid, 0) == -1) {
return fail("tpresume");
}
printf("after resume: %d\n", tpgetlev());
// tpcommit ends the transaction with a commit; without participants
// this is trivial, with resource managers it runs two-phase commit
if (tpcommit(0) == -1) {
return fail("tpcommit");
}
printf("after commit: %d\n", tpgetlev());
if (tpbegin(30, 0) == -1) {
return fail("tpbegin");
}
// tpabort rolls the transaction back
if (tpabort(0) == -1) {
return fail("tpabort");
}
printf("after abort: %d\n", tpgetlev());
return 0;
}
fuxedo: supported. Cross-checked against Oracle Tuxedo 12.2.2 and 22.1 with the API hardening suite.