ca.idms.jdbc
Class IdmsLogicalConnection

java.lang.Object
  ca.idms.io.TraceObject
      ca.idms.jdbc.IdmsJdbcObject
          ca.idms.jdbc.IdmsLogicalConnection

All Implemented Interfaces:

Trace, SQLState, java.sql.Connection, java.sql.Wrapper

public class IdmsLogicalConnection
extends IdmsJdbcObject
implements java.sql.Connection

Logical connection implementation for the CA IDMS JDBC Driver. When connection pooling is used with the CA IDMS JDBC Driver the IdmsPooledConnection.getConnection method returns an instance of this class, which serves as the "object handle" for the connection. All methods other than close() and isClosed() invoke the corresponding methods in the physical IdmsConnection object (even when not supported).

Author:

Dave Ross

See Also:

IdmsConnection, IdmsPooledConnection

Field Summary

Fields inherited from class ca.idms.jdbc.IdmsJdbcObject

FAKE_METHODS, FAKE_SUPPORT, fakeSupport, MESSAGES

Fields inherited from class ca.idms.io.TraceObject

exclude, EXCLUDE, FALSE, include, INCLUDE, logWriter, PREFIX, PROPERTIES_FILE, PROPERTIES_KEY, snap, SNAP, SNAP_BYTES, SNAP_NATIVE, SNAP_OBJECT, SNAP_SQL, snapBytes, snapNative, snapObject, snapSql, stub, trace, TRACE, TRACE_FILE, TRACE_LIFE, TRACE_NATIVE, TRACE_PRODUCT, traceLife, traceNative, traceStream, TRUE

Fields inherited from interface java.sql.Connection

TRANSACTION_NONE, TRANSACTION_READ_COMMITTED, TRANSACTION_READ_UNCOMMITTED, TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE

Fields inherited from interface ca.idms.qcli.SQLState

SQL_00000, SQL_01000, SQL_01004, SQL_07001, SQL_07009, SQL_08001, SQL_08002, SQL_08003, SQL_08004, SQL_08006, SQL_08007, SQL_0A000, SQL_21000, SQL_22000, SQL_22001, SQL_22003, SQL_22005, SQL_22007, SQL_24000, SQL_25000, SQL_3C000, SQL_40000, SQL_42000, SQL_HY000, SQL_HY004, SQL_HY009, SQL_HY010, SQL_HY024, SQL_HY106, SQL_HYC00

Method Summary

void	clearWarnings() Sets the warning chain to null.
void	close() Closes the logical connection.
void	commit() Invokes IdmsConnection.commit().
java.sql.Array	createArrayOf(java.lang.String arg0, java.lang.Object[] arg1) IDMS does not support the ARRAY type.
java.sql.Blob	createBlob() IDMS does not support the BLOB type.
java.sql.Clob	createClob() IDMS does not support the CLOB type.
java.sql.NClob	createNClob() IDMS does not support the NCLOB type.
java.sql.SQLXML	createSQLXML() IDMS does not support the SQLMXL type.
java.sql.Statement	createStatement() Invokes IdmsConnection.createStatement().
java.sql.Statement	createStatement(int type, int conc) Invokes IdmsConnection.createStatement(int,int).
java.sql.Statement	createStatement(int type, int conc, int hold) Invokes IdmsConnection.createStatement(int,int,int).
java.sql.Struct	createStruct(java.lang.String arg0, java.lang.Object[] arg1) IDMS does not support the STRUCT type.
protected java.lang.Object	get(java.lang.reflect.Field f) Allows the default snap method access to non-public variables.
boolean	getAutoCommit() Invokes IdmsConnection.getAutoCommit().
java.lang.String	getCatalog() Invokes IdmsConnection.getCatalog().
java.util.Properties	getClientInfo() Returns the set of ClientInfo properties and their associated values.
java.lang.String	getClientInfo(java.lang.String s) Returns the current value of a ClientInfo property, or null if the property doesn't exist.
int	getHoldability() Invokes IdmsConnection.getHoldability().
java.sql.DatabaseMetaData	getMetaData() Invokes IdmsConnection.getMetaData().
int	getTransactionIsolation() Invokes IdmsConnection.getTransactionIsolation().
java.util.Map<java.lang.String,java.lang.Class<?>>	getTypeMap() Invokes IdmsConnection.getTypeMap().
java.sql.SQLWarning	getWarnings() The first warning reported by calls on this object is returned.
boolean	isClosed() Tests to see if the logical connection has been closed.
boolean	isReadOnly() Invokes IdmsConnection.isReadOnly().
boolean	isValid(int t) Returns true if the connection has not been closed and is still valid.
java.lang.String	nativeSQL(java.lang.String sql) Invokes IdmsConnection.nativeSQL(String).
java.sql.CallableStatement	prepareCall(java.lang.String sql) Invokes IdmsConnection.prepareCall(String).
java.sql.CallableStatement	prepareCall(java.lang.String sql, int type, int conc) Invokes IdmsConnection.prepareCall(String,int,int).
java.sql.CallableStatement	prepareCall(java.lang.String sql, int type, int conc, int hold) Invokes IdmsConnection.prepareCall(String,int,int,int).
java.sql.PreparedStatement	prepareStatement(java.lang.String sql) Invokes IdmsConnection.prepareStatement(String).
java.sql.PreparedStatement	prepareStatement(java.lang.String sql, int key) Invokes IdmsConnection.prepareStatement(String,int).
java.sql.PreparedStatement	prepareStatement(java.lang.String sql, int[] index) Invokes IdmsConnection.prepareStatement(String,int[]).
java.sql.PreparedStatement	prepareStatement(java.lang.String sql, int type, int conc) Invokes IdmsConnection.prepareStatement(String,int,int).
java.sql.PreparedStatement	prepareStatement(java.lang.String sql, int type, int conc, int hold) Invokes IdmsConnection.prepareStatement(String,int,int,int).
java.sql.PreparedStatement	prepareStatement(java.lang.String sql, java.lang.String[] names) Invokes IdmsConnection.prepareStatement(String,String[]).
void	releaseSavepoint(java.sql.Savepoint savepoint) Invokes IdmsConnection.releaseSavepoint(Savepoint).
void	rollback() Invokes IdmsConnection.rollback().
void	rollback(java.sql.Savepoint savepoint) Invokes IdmsConnection.rollback(Savepoint).
void	setAutoCommit(boolean autoCommit) Invokes IdmsConnection.setAutoCommit(boolean).
void	setCatalog(java.lang.String catalog) Invokes IdmsConnection.setCatalog(String).
void	setClientInfo(java.util.Properties p) Sets ClientInfo properties to those passed by the application.
void	setClientInfo(java.lang.String k, java.lang.String v) Sets a ClientInfo property as requested by the application.
void	setHoldability(int hold) Invokes IdmsConnection.setHoldability(int).
void	setReadOnly(boolean readOnly) Invokes IdmsConnection.setReadOnly(boolean).
java.sql.Savepoint	setSavepoint() Invokes IdmsConnection.setSavepoint().
java.sql.Savepoint	setSavepoint(java.lang.String name) Invokes IdmsConnection.setSavepoint(String).
void	setTransactionIsolation(int level) Invokes IdmsConnection.setTransactionIsolation(int).
void	setTypeMap(java.util.Map<java.lang.String,java.lang.Class<?>> map) Invokes IdmsConnection.setTypeMap(Map).
void	WASclose() Special close method for WebSphere.

Methods inherited from class ca.idms.jdbc.IdmsJdbcObject

hasCursor, hasUpdate, isStarted, isSuspended, isWrapperFor, notifyStatementError, unwrap

Methods inherited from class ca.idms.io.TraceObject

finalize, getBoolean, getClasses, getInteger, getProperty, listProperties, message, parseList, print, print, print, println, println, snap, snap, snap, snap, snap, snap, snap, toHex, toHex, toHex, toHex, toHex, toString, trace, trace, trace, trace, trace, trace, traceEntry, unloadProperties

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.sql.Wrapper

isWrapperFor, unwrap

Method Detail

get

protected java.lang.Object get(java.lang.reflect.Field f)
                        throws java.lang.IllegalAccessException

Allows the default snap method access to non-public variables.

Overrides:

get in class IdmsJdbcObject

Parameters:

f - a Field returned by Class.getDeclaredFields

Returns:

the Object named by f

Throws:

java.lang.IllegalAccessException - should not happen

See Also:

TraceObject.snap, TraceObject.snap()

close

public void close()
           throws java.sql.SQLException

Closes the logical connection. Notifies the connection pool manager that the application has closed the logical connection.

Specified by:

close in interface java.sql.Connection

Throws:

java.sql.SQLException - if the session fails on suspend or commit

isClosed

public boolean isClosed()
                 throws java.sql.SQLException

Tests to see if the logical connection has been closed.

Specified by:

isClosed in interface java.sql.Connection

Returns:

true if the connection is closed; false if it's still open

Throws:

java.sql.SQLException - not

See Also:

IdmsConnection.isClosed()

clearWarnings

public void clearWarnings()
                   throws java.sql.SQLException

Sets the warning chain to null.

Specified by:

clearWarnings in interface java.sql.Connection

Overrides:

clearWarnings in class IdmsJdbcObject

Throws:

java.sql.SQLException - if the logical connection is closed

getWarnings

public java.sql.SQLWarning getWarnings()
                                throws java.sql.SQLException

The first warning reported by calls on this object is returned.

Specified by:

getWarnings in interface java.sql.Connection

Overrides:

getWarnings in class IdmsJdbcObject

Returns:

the first SQLWarning or null

Throws:

java.sql.SQLException - if the logical connection is closed

createStatement

public java.sql.Statement createStatement()
                                   throws java.sql.SQLException

Invokes IdmsConnection.createStatement().

Specified by:

createStatement in interface java.sql.Connection

Returns:

a new Statement object

Throws:

java.sql.SQLException - if a database error occurs.

prepareStatement

public java.sql.PreparedStatement prepareStatement(java.lang.String sql)
                                            throws java.sql.SQLException

Invokes IdmsConnection.prepareStatement(String).

Specified by:

prepareStatement in interface java.sql.Connection

Parameters:

sql - an SQL statement

Returns:

a new PreparedStatement object

Throws:

java.sql.SQLException - if a database error occurs.

prepareCall

public java.sql.CallableStatement prepareCall(java.lang.String sql)
                                       throws java.sql.SQLException

Invokes IdmsConnection.prepareCall(String).

Specified by:

prepareCall in interface java.sql.Connection

Parameters:

sql - an SQL statement

Returns:

a new CallableStatement object

Throws:

java.sql.SQLException

nativeSQL

public java.lang.String nativeSQL(java.lang.String sql)
                           throws java.sql.SQLException

Invokes IdmsConnection.nativeSQL(String).

Specified by:

nativeSQL in interface java.sql.Connection

Parameters:

sql - an SQL statement

Returns:

the native form of this statement

Throws:

java.sql.SQLException - if an error occurs.

commit

public void commit()
            throws java.sql.SQLException

Invokes IdmsConnection.commit().

Specified by:

commit in interface java.sql.Connection

Throws:

java.sql.SQLException - if a database error occurs.

rollback

public void rollback()
              throws java.sql.SQLException

Invokes IdmsConnection.rollback().

Specified by:

rollback in interface java.sql.Connection

Throws:

java.sql.SQLException - if a database error occurs.

setCatalog

public void setCatalog(java.lang.String catalog)
                throws java.sql.SQLException

Invokes IdmsConnection.setCatalog(String).

Specified by:

setCatalog in interface java.sql.Connection

Parameters:

catalog - name, ignored.

Throws:

java.sql.SQLException - NOT!

getCatalog

public java.lang.String getCatalog()
                            throws java.sql.SQLException

Invokes IdmsConnection.getCatalog().

Specified by:

getCatalog in interface java.sql.Connection

Returns:

the dictionary name if known, dsn otherwise.

Throws:

java.sql.SQLException - does not happen.

getMetaData

public java.sql.DatabaseMetaData getMetaData()
                                      throws java.sql.SQLException

Invokes IdmsConnection.getMetaData().

Specified by:

getMetaData in interface java.sql.Connection

Returns:

a DatabaseMetaData object for this Connection

Throws:

java.sql.SQLException - if a database error occurs.

setAutoCommit

public void setAutoCommit(boolean autoCommit)
                   throws java.sql.SQLException

Invokes IdmsConnection.setAutoCommit(boolean).

Specified by:

setAutoCommit in interface java.sql.Connection

Parameters:

autoCommit - true or false

Throws:

java.sql.SQLException - if a database error occurs.

getAutoCommit

public boolean getAutoCommit()
                      throws java.sql.SQLException

Invokes IdmsConnection.getAutoCommit().

Specified by:

getAutoCommit in interface java.sql.Connection

Returns:

Current state of auto-commit mode.

Throws:

java.sql.SQLException - if a database error occurs.

setReadOnly

public void setReadOnly(boolean readOnly)
                 throws java.sql.SQLException

Invokes IdmsConnection.setReadOnly(boolean).

Specified by:

setReadOnly in interface java.sql.Connection

Parameters:

readOnly - true or false

Throws:

java.sql.SQLException - if a database error occurs.

isReadOnly

public boolean isReadOnly()
                   throws java.sql.SQLException

Invokes IdmsConnection.isReadOnly().

Specified by:

isReadOnly in interface java.sql.Connection

Returns:

true if connection is read-only

Throws:

java.sql.SQLException - if a database error occurs.

setTransactionIsolation

public void setTransactionIsolation(int level)
                             throws java.sql.SQLException

Invokes IdmsConnection.setTransactionIsolation(int).

Specified by:

setTransactionIsolation in interface java.sql.Connection

Parameters:

level - one of the TRANSACTION_* isolation values

Throws:

java.sql.SQLException - if a database error occurs.

getTransactionIsolation

public int getTransactionIsolation()
                            throws java.sql.SQLException

Invokes IdmsConnection.getTransactionIsolation().

Specified by:

getTransactionIsolation in interface java.sql.Connection

Returns:

the current TRANSACTION_* mode value

Throws:

java.sql.SQLException - if a database error occurs.

createStatement

public java.sql.Statement createStatement(int type,
                                          int conc)
                                   throws java.sql.SQLException

Invokes IdmsConnection.createStatement(int,int).

Specified by:

createStatement in interface java.sql.Connection

Parameters:

type - ResultSet type

conc - ResultSet concurrency

Returns:

an IdmsStatement object

Throws:

java.sql.SQLException - if an error occurs

Since:

1.2

prepareStatement

public java.sql.PreparedStatement prepareStatement(java.lang.String sql,
                                                   int type,
                                                   int conc)
                                            throws java.sql.SQLException

Invokes IdmsConnection.prepareStatement(String,int,int).

Specified by:

prepareStatement in interface java.sql.Connection

Parameters:

sql - SQL statement to prepare

type - ResultSet type

conc - ResultSet concurrency

Returns:

an IdmsPreparedStatement object

Throws:

java.sql.SQLException - if an error occurs

Since:

1.2

prepareCall

public java.sql.CallableStatement prepareCall(java.lang.String sql,
                                              int type,
                                              int conc)
                                       throws java.sql.SQLException

Invokes IdmsConnection.prepareCall(String,int,int).

Specified by:

prepareCall in interface java.sql.Connection

Parameters:

sql - SQL statement to prepare

type - ResultSet type

conc - ResultSet concurrency

Returns:

an IdmsCallableStatement object

Throws:

java.sql.SQLException - if an error occurs

Since:

1.2

getTypeMap

public java.util.Map<java.lang.String,java.lang.Class<?>> getTypeMap()
                                                              throws java.sql.SQLException

Invokes IdmsConnection.getTypeMap().

Specified by:

getTypeMap in interface java.sql.Connection

Returns:

the current Map object, for what it's worth

Throws:

java.sql.SQLException - never

Since:

1.2

setTypeMap

public void setTypeMap(java.util.Map<java.lang.String,java.lang.Class<?>> map)
                throws java.sql.SQLException

Invokes IdmsConnection.setTypeMap(Map).

Specified by:

setTypeMap in interface java.sql.Connection

Parameters:

map - the Map object, which we won't really use

Throws:

java.sql.SQLException - never

Since:

1.2

setHoldability

public void setHoldability(int hold)
                    throws java.sql.SQLException

Invokes IdmsConnection.setHoldability(int).

Specified by:

setHoldability in interface java.sql.Connection

Parameters:

hold - ResultSet holdability option

Throws:

java.sql.SQLException - if an invalid option is specified

Since:

1.4

See Also:

createStatement(int,int), prepareStatement(String,int,int), prepareCall(String,int,int)

getHoldability

public int getHoldability()
                   throws java.sql.SQLException

Invokes IdmsConnection.getHoldability().

Specified by:

getHoldability in interface java.sql.Connection

Returns:

current current holdability option

Throws:

java.sql.SQLException - never

Since:

1.4

See Also:

setHoldability(int)

setSavepoint

public java.sql.Savepoint setSavepoint()
                                throws java.sql.SQLException

Invokes IdmsConnection.setSavepoint().

Specified by:

setSavepoint in interface java.sql.Connection

Returns:

never

Throws:

java.sql.SQLException - always

Since:

1.4

See Also:

IdmsJdbcObject.fakeSupport

setSavepoint

public java.sql.Savepoint setSavepoint(java.lang.String name)
                                throws java.sql.SQLException

Invokes IdmsConnection.setSavepoint(String).

Specified by:

setSavepoint in interface java.sql.Connection

Parameters:

name - Savepoint name

Returns:

never

Throws:

java.sql.SQLException - always

Since:

1.4

See Also:

IdmsJdbcObject.fakeSupport

rollback

public void rollback(java.sql.Savepoint savepoint)
              throws java.sql.SQLException

Invokes IdmsConnection.rollback(Savepoint).

Specified by:

rollback in interface java.sql.Connection

Parameters:

savepoint - Savepoint object, ignored

Throws:

java.sql.SQLException - always

Since:

1.4

See Also:

IdmsJdbcObject.fakeSupport

releaseSavepoint

public void releaseSavepoint(java.sql.Savepoint savepoint)
                      throws java.sql.SQLException

Invokes IdmsConnection.releaseSavepoint(Savepoint).

Specified by:

releaseSavepoint in interface java.sql.Connection

Parameters:

savepoint - Savepoint object, ignored

Throws:

java.sql.SQLException - always

Since:

1.4

See Also:

IdmsJdbcObject.fakeSupport

createStatement

public java.sql.Statement createStatement(int type,
                                          int conc,
                                          int hold)
                                   throws java.sql.SQLException

Invokes IdmsConnection.createStatement(int,int,int).

Specified by:

createStatement in interface java.sql.Connection

Parameters:

type - ResultSet type

conc - ResultSet concurrency

hold - ResultSet holdability

Returns:

an IdmsStatement object

Throws:

java.sql.SQLException - if an error occurs

Since:

1.4

See Also:

setHoldability(int), createStatement(int, int)

prepareStatement

public java.sql.PreparedStatement prepareStatement(java.lang.String sql,
                                                   int type,
                                                   int conc,
                                                   int hold)
                                            throws java.sql.SQLException

Invokes IdmsConnection.prepareStatement(String,int,int,int).

Specified by:

prepareStatement in interface java.sql.Connection

Parameters:

sql - SQL statement to prepare

type - ResultSet type

conc - ResultSet concurrency

hold - ResultSet holdability, sets for all

Returns:

an IdmsPreparedStatement object

Throws:

java.sql.SQLException - if an error occurs

Since:

1.4

See Also:

setHoldability(int)

prepareCall

public java.sql.CallableStatement prepareCall(java.lang.String sql,
                                              int type,
                                              int conc,
                                              int hold)
                                       throws java.sql.SQLException

Invokes IdmsConnection.prepareCall(String,int,int,int).

Specified by:

prepareCall in interface java.sql.Connection

Parameters:

sql - SQL CALL statement to prepare

type - ResultSet type

conc - ResultSet concurrency

hold - ResultSet holdability, sets for all

Returns:

an IdmsCallableStatement object

Throws:

java.sql.SQLException - if an error occurs

Since:

1.4

See Also:

setHoldability(int)

prepareStatement

public java.sql.PreparedStatement prepareStatement(java.lang.String sql,
                                                   int key)
                                            throws java.sql.SQLException

Invokes IdmsConnection.prepareStatement(String,int).

Specified by:

prepareStatement in interface java.sql.Connection

Parameters:

sql - SQL statement

key - auto generated key flag, ignored

Returns:

the prepared statement object

Throws:

java.sql.SQLException - if an error occurs

Since:

1.4

prepareStatement

public java.sql.PreparedStatement prepareStatement(java.lang.String sql,
                                                   int[] index)
                                            throws java.sql.SQLException

Invokes IdmsConnection.prepareStatement(String,int[]).

Specified by:

prepareStatement in interface java.sql.Connection

Parameters:

sql - SQL statement

index - auto generated key ordinal array, ignored

Returns:

the prepared statement object, maybe

Throws:

java.sql.SQLException - if an error occurs

Since:

1.4

prepareStatement

public java.sql.PreparedStatement prepareStatement(java.lang.String sql,
                                                   java.lang.String[] names)
                                            throws java.sql.SQLException

Invokes IdmsConnection.prepareStatement(String,String[]).

Specified by:

prepareStatement in interface java.sql.Connection

Parameters:

sql - SQL statement

names - auto generated key column name array, ignored

Returns:

the prepared statement object

Throws:

java.sql.SQLException - if we can't do it or an error occurs

Since:

1.4

createArrayOf

public java.sql.Array createArrayOf(java.lang.String arg0,
                                    java.lang.Object[] arg1)
                             throws java.sql.SQLException

IDMS does not support the ARRAY type.

Specified by:

createArrayOf in interface java.sql.Connection

Throws:

java.sql.SQLException - always

Since:

1.6

createBlob

public java.sql.Blob createBlob()
                         throws java.sql.SQLException

IDMS does not support the BLOB type.

Specified by:

createBlob in interface java.sql.Connection

Throws:

java.sql.SQLException - always

Since:

1.6

createClob

public java.sql.Clob createClob()
                         throws java.sql.SQLException

IDMS does not support the CLOB type.

Specified by:

createClob in interface java.sql.Connection

Throws:

java.sql.SQLException - always

Since:

1.6

createNClob

public java.sql.NClob createNClob()
                           throws java.sql.SQLException

IDMS does not support the NCLOB type.

Specified by:

createNClob in interface java.sql.Connection

Throws:

java.sql.SQLException - always

Since:

1.6

createSQLXML

public java.sql.SQLXML createSQLXML()
                             throws java.sql.SQLException

IDMS does not support the SQLMXL type.

Specified by:

createSQLXML in interface java.sql.Connection

Throws:

java.sql.SQLException - always

Since:

1.6

createStruct

public java.sql.Struct createStruct(java.lang.String arg0,
                                    java.lang.Object[] arg1)
                             throws java.sql.SQLException

IDMS does not support the STRUCT type.

Specified by:

createStruct in interface java.sql.Connection

Throws:

java.sql.SQLException - always

Since:

1.6

getClientInfo

public java.util.Properties getClientInfo()
                                   throws java.sql.SQLException

Returns the set of ClientInfo properties and their associated values.

Specified by:

getClientInfo in interface java.sql.Connection

Throws:

java.sql.SQLException - if connection is closed

Since:

1.6

getClientInfo

public java.lang.String getClientInfo(java.lang.String s)
                               throws java.sql.SQLException

Returns the current value of a ClientInfo property, or null if the property doesn't exist.

Specified by:

getClientInfo in interface java.sql.Connection

Parameters:

s - the property key

Throws:

java.sql.SQLException - if connection is closed

Since:

1.6

isValid

public boolean isValid(int t)
                throws java.sql.SQLException

Returns true if the connection has not been closed and is still valid. The driver sends a query to the IDMS system to verify the connection.

Specified by:

isValid in interface java.sql.Connection

Parameters:

t - the number of seconds to wait for completion of the validating query to the IDMS system.

Throws:

java.sql.SQLException - if the requested timeout value is less than zero.

Since:

1.6

setClientInfo

public void setClientInfo(java.util.Properties p)
                   throws java.sql.SQLClientInfoException

Sets ClientInfo properties to those passed by the application. Any ClientInfo properties which are not included, but were previously set by the application, are set to their default values.

Specified by:

setClientInfo in interface java.sql.Connection

Parameters:

p - collection of ClientInfo properties to be set.

Throws:

java.sql.SQLClientInfoException - - if one or more of the properties fails to be set, or this method is called on a closed connection.

Since:

1.6

setClientInfo

public void setClientInfo(java.lang.String k,
                          java.lang.String v)
                   throws java.sql.SQLClientInfoException

Sets a ClientInfo property as requested by the application. If the property key is not supported, a SQLWarning is created

Specified by:

setClientInfo in interface java.sql.Connection

Parameters:

k - property key

v - property value

Throws:

java.sql.SQLClientInfoException - - the property fails to be set.

Since:

1.6

WASclose

public void WASclose()
              throws java.sql.SQLException

Special close method for WebSphere. WebSphere does not call IdmsLogicalConnection.close until right before a connection is to be purged from the connection pool. This behavior does not comply with the JDBC spec, but it's obviously easier for us to accommodate it than to expect that IBM would ever change it. This class is called by the WebSphere helper class' doConnectionCleanup method.

Throws:

java.sql.SQLException - if the session fails on suspend or commit