xa_end()--End Work on an XA Transaction Branch (Transaction Scoped Locks)
Syntax
#include <xa.h>
int xa_switch.xa_end_entry(XID *xid, int rmid,
long flags);
Default Public Authority: *USE
Service Program: QTNXADTP
Threadsafe: Yes
A transaction manager calls xa_end() when an application thread of control finishes or needs to suspend work on a transaction branch. When xa_end() successfully returns, the calling thread of control is no longer associated with the transaction branch, but the branch still exists.
If the TMSUSPEND flag is not specified, all SQL cursors used while the thread was associated with this transaction branch are closed. Files left open by a procedure, trigger or function that used legacy file access methods are closed regardless of flag settings.
Parameters
- *xid
- (Input) A pointer to the transaction branch identifier. This identifier was
generated by the transaction manager when the transaction branch was
started.
- rmid
- (Input) An integer value that the transaction manager generated when
calling xa_open(). The rmid identifies the resource
manager.
- flags
- (Input) The following are valid settings of flags. One, and only
one, of TMSUSPEND, TMSUCCESS, or TMFAIL must be set.
TMSUSPEND: 0x02000000L Suspend a transaction branch on behalf of the calling thread. The transaction manager must resume or end the suspended association in the current thread.
TMSUCCESS: 0x04000000L The portion of work has succeeded.
TMFAIL: 0x20000000L The portion of work has failed.
Authorities
None
Return Value
The following return codes indicate that the resource manager has marked the work performed on this transaction branch as rollback-only.
| 100 | [XA_RBROLLBACK]
The transaction branch was marked rollback-only for an unspecified reason. |
| 101 | [XA_RBCOMMFAIL]
A communications failure occurred within the resource manager. |
| 102 | [XA_RBDEADLOCK]
A deadlock condition was detected within the resource manager. |
| 103 | [XA_RBINTEGRITY]
The resource manager detected a violation of the integrity of its resources. |
| 104 | [XA_RBOTHER]
The resource manager marked the transaction branch rollback-only for a reason not on this list. |
| 105 | [XA_RBPROTO]
A protocol error occurred in the resource manager. |
| 106 | [XA_RBTIMEOUT]
A timeout occurred in the resource manager. |
| 107 | [XA_RBTRANSIENT]
A transient error was detected by the resource manager. |
Other return codes:
| -7 | [XAER_RMFAIL]
An error occurred that makes the resource manager unavailable. |
| -6 | [XAER_PROTO]
Function was called in an improper context. |
| -5 | [XAER_INVAL]
Incorrect arguments were specified. |
| -4 | [XAER_NOTA]
The specified *xid is not known by the resource manager. |
| -3 | [XAER_RMERR]
xa_end() was not successful. The resource manager detected an error when ending the transaction branch. |
| -2 | [XAER_ASYNC]
xa_end() was not successful. The resource manager does not support asynchronous operations. |
| 0 | [XA_OK]
xa_end() was successful. |
| 9 | [XA_NOMIGRATE]
The resource manager was unable to prepare the transaction context for migration. The resource manager has suspended the association. The transaction manager can resume the association in the current thread only. |
Error Messages
The following messages may be sent from this function.
| Message ID | Error Message Text |
|---|---|
| CPE3418 E | Possible APAR condition or hardware failure. |
| CPF3CF2 E | Error(s) occurred during running of &1 API. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
Related Information
- X/Open CAE Specification, December 1991, Distributed Transaction
Processing: The XA Specification (ISBN:1-872630-24-3, C193 or XO/CAE/91/300),
The Open Group.
- X/Open CAE Specification, April 1995, Distributed Transaction Processing: The TX (Transaction Demarcation) Specification (ISBN:1-85912-094-6, C504), The Open Group.
Example
Note: By using the code examples, you agree to the terms of the Code license and disclaimer information.
#include <xa.h>
main() {
XID *xid;
int rmid;
long flags;
int retcode;
extern struct xa_switch_t xa_switch;
retcode =
xa_switch.xa_end_entry(xid, rmid, flags);
}
API introduced: V5R2