|
|
TPRESUME(3cbl)
Name
TPRESUME() - resume a global transaction
Synopsis
01 TPTRXDEF-REC.
COPY TPTRXDEF.
01 TPSTATUS-REC.
COPY TPSTATUS.
CALL "TPRESUME" USING TPTRXDEF-REC TPSTATUS-REC.
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 contained in TRANID().
Return Value
Upon successful completion, TPRESUME() sets [TPOK].
Errors
Under the following conditions, TPRESUME() fails and sets TP-STATUS to:
Notes
XA-compliant resource managers must be successfully opened to be included in the global transaction. (See TPOPEN() for details.)
A program resuming a suspended transaction must reside on the same logical machine (LMID) as the program 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(3cbl), TPCOMMIT(3cbl), TPOPEN(3cbl), TPSUSPEND(3cbl)
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|