|
|
tpresume(3c)
Name
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(), or complete it with one of tpcommit() or tpabort() at a later time.
The caller must ensure that its linked resource managers have been opened (via tpopen()) 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.
In a multithreaded application, a thread in the TPINVALIDCONTEXT state is not allowed to issue a call to tpresume().
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:
Notes
XA-compliant resource managers must be successfully opened to be included in the global transaction. (See tpopen(3c) for details.)
A process resuming a suspended transaction must reside on the same logical machine (LMID) as the process that suspended the transaction. For a workstation client, the workstation handler (WSH) to which it is connected must reside on the same logical machine as the handler for the workstation client that suspended the transaction.
See Also
tpabort(3c), tpcommit(3c), tpopen(3c), tpsuspend(3c)
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|