are we in transaction mode?
#include <atmi.h>
int tpgetlev(void);
tpgetlev() reports whether the caller is in transaction mode: TP_IN_TRANSACTION (1) or TP_NOT_IN_TRANSACTION (0). Cheap enough to call freely when code paths branch on the transaction state.
| Code | Description |
|---|---|
| TPESYSTEM | Platform failure answering the query. |
Full source: docs/api/examples/txdemo.c
(build and run with make -C docs/api/examples check
TUXDIR=<install>); the lines documenting tpgetlev() 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.