com.ibm.as400.access
Class AS400JDBCSavepoint

java.lang.Object
  |
  +--com.ibm.as400.access.AS400JDBCSavepoint
All Implemented Interfaces:
java.sql.Savepoint

public class AS400JDBCSavepoint
extends java.lang.Object
implements java.sql.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 OS/400 server does not support nnnamed savepoints so internally the Toolbox JDBC driver will create a name to send to the server. The format is T_JDBCINTERNAL_n where 'n' is a counter that is incremented every time an unnamed savepoint is created.

Considerations:

The release after OS/400 V5R1 or later 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.
 java.lang.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 java.sql.SQLException
Returns the generated ID for the savepoint that this Savepoint object represents.
Specified by:
getSavepointId in interface java.sql.Savepoint
Returns:
the numeric ID of this savepoint.
Throws:
java.sql.SQLException - if this is a named savepoint.

getSavepointName

public java.lang.String getSavepointName()
                                  throws java.sql.SQLException
Returns the name for the savepoint that this Savepoint object represents.
Specified by:
getSavepointName in interface java.sql.Savepoint
Returns:
the name of this savepoint.
Throws:
java.sql.SQLException - if this is an un-named savepoint.