com.ibm.as400.access
Class AS400JDBCSavepoint

java.lang.Object
  extended bycom.ibm.as400.access.AS400JDBCSavepoint
All Implemented Interfaces:
Savepoint

public class AS400JDBCSavepoint
extends Object
implements Savepoint

The AS400JDBCSavepoint class is the Toolbox JDBC driver's representation of a savepoint. A savepoint is a point within the current transaction that can be referenced from the Connection.rollback(savepoint) method. When a transaction is rolled back to a savepoint, all changes made after the savepoint was created are undone.

Savepoints can be either named or unnamed. The DB2 for i5/OS does not support unnamed savepoints so internally the Toolbox JDBC driver will create a name to send to the system. The format is T_JDBCINTERNAL_n where 'n' is a counter that is incremented every time an unnamed savepoint is created.

Considerations:

OS/400 V5R2 or i5/OS is required to use savepoints. Savepoint support is new in modification 5 of the Toolbox JDBC driver.


Method Summary
 int getSavepointId()
          Returns the generated ID for the savepoint that this Savepoint object represents.
 String getSavepointName()
          Returns the name for the savepoint that this Savepoint object represents.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getSavepointId

public int getSavepointId()
                   throws SQLException
Returns the generated ID for the savepoint that this Savepoint object represents.

Specified by:
getSavepointId in interface Savepoint
Returns:
the numeric ID of this savepoint.
Throws:
SQLException - if this is a named savepoint.

getSavepointName

public String getSavepointName()
                        throws SQLException
Returns the name for the savepoint that this Savepoint object represents.

Specified by:
getSavepointName in interface Savepoint
Returns:
the name of this savepoint.
Throws:
SQLException - if this is an un-named savepoint.