RollbackOnly (obsolete)
PowerScript function
Description
Modifies an EAServer transaction associated with a calling thread so
that the only possible outcome is to roll back the transaction.
Obsolete function
RollbackOnly is obsolete, because EAServer is no longer supported
since PowerBuilder 2017.
Applies to
CORBACurrent objects
Syntax
|
1 |
CORBACurrent.RollbackOnly ( ) |
|
Argument |
Description |
|---|---|
|
CORBACurrent |
Reference to the CORBACurrent service |
Return value
Integer. Returns 0 if it succeeds and one of the following negative
values if an error occurs:
-1 — Failed for unknown reason
-2 — No transaction is associated with the calling thread
Usage
RollbackTransaction is typically called by the originator of the
transaction. Another participant in a client- or OTS style transaction can
call RollbackOnly to vote that the transaction should be rolled
back.
RollbackOnly can be called by a client or a component that is marked
as OTS style. EAServer must be using the two-phase commit transaction
coordinator (OTS/XA).
Examples
In this example, a participant in a transaction has determined that
it should be rolled back. It creates and initializes an instance of the
CORBACurrent service object and votes to roll back the transaction:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
// Instance variable: // CORBACurrent corbcurr int li_rc li_rc = this.GetContextService("CORBACurrent", & corbcurr) IF li_rc <> 1 THEN // handle the error END IF li_rc = corbcurr.Init() IF li_rc <> 0 THEN // handle the error ELSE corbcurr.RollbackOnly() END IF |
See also