Package com.ibm.as400.access

Class AS400JDBCXAConnection

java.lang.Object

com.ibm.as400.access.AS400JDBCPooledConnection

com.ibm.as400.access.AS400JDBCXAConnection

All Implemented Interfaces:

PooledConnection, XAConnection

public class AS400JDBCXAConnection
extends AS400JDBCPooledConnection
implements XAConnection

The AS400JDBCXACConnection class represents a pooled connection object that provides hooks for connection pool management and XA resource management.

Because transaction boundaries are controlled by a transaction manager, the caller cannot explicitly commit or rollback on connections pooled by this object. In addition, auto commit is initialized to false and cannot be set to true.

This support is only available when connecting to systems running OS/400 V5R1 or later, or IBM i.

The following example creates an AS400JDBCXAConnection object that can be used to manage XA transactions.

// Create an XA data source for making the XA connection.
AS400JDBCXADataSource xaDataSource = new AS400JDBCXADataSource("myAS400");
xaDataSource.setUser("muUser");
xaDataSource.setPassword("myPasswd");

// Get an XAConnection and get the associated XAResource.
// This provides access to the resource manager.
XAConnection xaConnection = xaDataSource.getXAConnection();
XAResource xaResource = xaConnection.getXAResource();

// ... work with the XA resource.

// Close the XA connection when done.  This implicitly
// closes the XA resource.
xaConnection.close();

See Also:

AS400JDBCXADataSource, AS400JDBCXAResource

Method Summary

Modifier and Type	Method	Description
XAResource	getXAResource()	Returns the XA resource associated with this connection.

Methods inherited from class com.ibm.as400.access.AS400JDBCPooledConnection

addConnectionEventListener, addStatementEventListener, close, closeAll, equals, getConnection, getInactivityTime, getInUseTime, getLifeSpan, getUseCount, hashCode, isInUse, removeConnectionEventListener, removeStatementEventListener

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.sql.PooledConnection

addConnectionEventListener, addStatementEventListener, close, getConnection, removeConnectionEventListener, removeStatementEventListener

Method Detail

getXAResource

public XAResource getXAResource()
                         throws SQLException

Returns the XA resource associated with this connection. This implicitly opens the resource the first time it is called.

Specified by:

getXAResource in interface XAConnection

Returns:

The XA resource.

Throws:

SQLException - If an error occurs.