CommitTransaction (obsolete)

Description

Declares that the EAServer transaction associated with the calling thread should be committed.

Obsolete function

CommitTransaction is obsolete, because EAServer is no longer supported since PowerBuilder 2017.

Applies to

CORBACurrent objects

Syntax

CORBACurrent.CommitTransaction (breportheuristics )

Argument

Description

CORBACurrent

Reference to the CORBACurrent service instance

breportheuristics

A boolean specifying whether heuristic decisions should be reported for the transaction associated with the calling thread


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

-3 -- The calling thread does not have permission to commit the transaction

-4 -- The HeuristicRollback exception was raised

-5 -- The HeuristicMixed exception was raised

-6 -- The HeuristicHazard exception was raised

Usage

The CommitTransaction function completes the transaction associated with the calling thread. Use the BeginTransaction function to begin a transaction and associate it with the calling thread. The transaction is not completed if any other participants in the transaction vote to roll back the transaction.

CommitTransaction 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, the client calls the dopayroll method on the CmpnyAcct EAServer component, which processes a company payroll. The method returns 1 if the company has sufficient funds to meet the payroll, and the client then commits the transaction:

// Instance variables:
// CORBACurrent corbcurr
integer li_rc
boolean lb_rv
long ll_rc
// Create an instance of the CORBACurrent object
// and initialize it
...
lb_rv = corbcurr.BeginTransaction()
IF lb_rv THEN
    ll_rc = myconnect.CreateInstance(CmpnyAcct)
    // handle error
    li_rc = CmpnyAcct.dopayroll()
    IF li_rc = 1 THEN
      corbcurr.CommitTransaction(
    ELSE
      corbcurr.RollbackTransaction()
    END IF
ELSE
    // handle error
END IF

See also

BeginTransaction (obsolete)

GetContextService

GetStatus (obsolete)

GetTransactionName (obsolete)

Init (obsolete)

ResumeTransaction (obsolete)

RollbackOnly (obsolete)

RollbackTransaction (obsolete)

SetTimeout (obsolete)

SuspendTransaction (obsolete)