Novell exteNd Messaging Platform 5.2

com.sssw.jts.api.admin
Interface RecoveryTransaction


public interface RecoveryTransaction

Object that represents a transaction that has not completed and that requires recovery. This is part of the manual recovery process. TransactionManager returns an array of such objects as part of manualRecovery call.

 TransactionService jts;
 jts = (TransactionService)
      orb.resolve_initial_references("TransactionService");
 jts.recover(myResourceMapper, false, null);
 Enumeration e;
 transarr = jts.getRecoveryTransactions();
 while (e.hasMoreElements()) {
    RecoveryTransaction tx = (RecoveryTransaction)e.nextElement();
    ...
 }

See Also:
TransactionService

Field Summary
static int STATE_PREPARED
          All resoruces have prepared to commit.
static int STATE_PREPARED_REMOTE
          All resoruces have prepared to commit, waiting for remote coordinator to complete.
static int STATE_ROLLBACK_ONLY
          Transaction can only be rolled back.
 
Method Summary
 Throwable getRecoverException()
          Returns any Exception encountered during recovery.
 int getState()
          State of the transaction.
 XAResource[] getXAResources()
          The list of XAResources associated with the transaction
 Xid getXid()
          Transaction Xid.
 boolean recover()
          Complete the transaction.
 void release()
          Release the transaction to TM for recovery.
 void remove()
          Remove the transaction from recovery logs.
 

Field Detail

STATE_PREPARED

public static final int STATE_PREPARED
All resoruces have prepared to commit.

See Also:
Constant Field Values

STATE_ROLLBACK_ONLY

public static final int STATE_ROLLBACK_ONLY
Transaction can only be rolled back.

See Also:
Constant Field Values

STATE_PREPARED_REMOTE

public static final int STATE_PREPARED_REMOTE
All resoruces have prepared to commit, waiting for remote coordinator to complete.

See Also:
Constant Field Values
Method Detail

getState

public int getState()
State of the transaction.

Returns:
the state, STATE_PREPARED or STATE_ROLLBACK_ONLY

getXid

public Xid getXid()
Transaction Xid.

Returns:
Xid associated with the transaction.

getXAResources

public XAResource[] getXAResources()
The list of XAResources associated with the transaction

Returns:
array of XAResources.

recover

public boolean recover()
Complete the transaction.

Returns:
true recovery completed, else either an exception occured or a Resource was not active during completion and needs to be completed later.

getRecoverException

public Throwable getRecoverException()
Returns any Exception encountered during recovery.

Returns:
first exception encountered during recovery.

remove

public void remove()
Remove the transaction from recovery logs.


release

public void release()
Release the transaction to TM for recovery.


Novell exteNd Messaging Platform 5.2

exteNd is a registered trademark of Novell, Inc.
Copyright 1998-2004 Novell, Inc. All Rights Reserved.