PURPOSE

tpresume - resume a global transaction

SYNOPSIS

#include <atmi.h>
int tpresume(TPTRANID *tranid, long flags)

DESCRIPTION

tpresume() is used to resume work on behalf of a previously suspended transaction. Once the caller resumes work on a transaction, it must either suspend it with tpsuspend(3c), or complete it with one of tpcommit(3c) or tpabort(3c) at a later time.

The caller must ensure that its linked resource managers have been opened (via tpopen(3c)) before it can resume work on any transaction.

tpresume() places the caller in transaction mode on behalf of the global transaction identifier pointed to by tranid. It is an error for tranid to be NULL.

Currently, flags are reserved for future use and must be set to 0.

RETURN VALUE

tpresume() returns -1 on error and sets tperrno to indicate the error condition.

ERRORS

Under the following conditions, tpresume() fails and sets tperrno to:

[TPEINVAL]: Either tranid is a NULL pointer, it points to a non-existent transaction identifier (including previously completed or timed-out transactions), or it points to a transaction identifier that the caller is not allowed to resume. The caller's state with respect to the transaction is not changed.
[TPEMATCH]: tranid points to a transaction identifier that another process has already resumed. The caller's state with respect to the transaction is not changed.
[TPETRAN]: System/T is unable to resume the global transaction because the caller is currently participating in work outside any global transaction with one or more resource managers. All such work must be completed before a global transaction can be resumed. The caller's state with respect to the local transaction is unchanged.
[TPEPROTO]: tpresume() was called in an improper context (for example, the caller is already in transaction mode). The caller's state with respect to the transaction is not changed.
[TPESYSTEM]: A System/T error has occurred. The exact nature of the error is written to a log file.
[TPEOS]: An operating system error has occurred.

NOTES

XA-compliant resource managers must be successfully opened to be included in the global transaction. (See tpopen(3c) for details.)