com.ibm.ims.db.cci

Class IMSManagedConnectionFactory

java.lang.Object

com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

com.ibm.ims.db.cci.IMSManagedConnectionFactory

All Implemented Interfaces:

java.io.Serializable, javax.resource.spi.ManagedConnectionFactory, javax.resource.spi.ValidatingManagedConnectionFactory

public class IMSManagedConnectionFactory
extends com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Factory class used to create non-managed connections to IMS.

The following code fragment shows how to use IMSManagedConnectionFactory to obtain a Connection object.

 Connection connection = null;
 IMSManagedConnectionFactory mcf = new IMSManagedConnectionFactory();
 
 // Set connection properties
 mcf.setUser("myUserid");
 mcf.setPassword("myPassword");
 mcf.setDatastoreName("IMS1");
 mcf.setDatastoreServer("ec0123.my.host.com");
 mcf.setPortNumber(5555);
 mcf.setDatabaseName("class://testcases.jdbo.BMP255DatabaseView");
 mcf.setSSLConnection(false);
 mcf.setDriverType(IMSManagedConnectionFactory.DRIVER_TYPE_4);
 mcf.setLoginTimeout(10);
 
 // Create CCI Connection
 private ConnectionFactoryImpl cf = (ConnectionFactoryImpl) mcf.createConnectionFactory();
 connection = cf.getConnection();
 

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DRIVER_TYPE_2
static java.lang.String	DRIVER_TYPE_2_CTX
static java.lang.String	DRIVER_TYPE_4 Constant indicating the driver is pure Java and implements the network protocol for the data source.

Constructor Summary

Constructors

Constructor and Description
IMSManagedConnectionFactory()

Method Summary

Modifier and Type	Method and Description
java.lang.Object	createConnectionFactory() Creates a ConnectionFactory instance.
java.lang.String	getCurrentSchema() Retrieves the current schema.
java.lang.String	getDatabaseName() Retrieves the name of the target IMS database.
java.lang.String	getDatastoreName() Retrieves name of the IMS datastore.
java.lang.String	getDatastoreServer() Retrieves the name or IP address of your datastore server (IMS Connect).
java.lang.String	getDriverType() Retrieves the database connectivity method.
boolean	getExpandArrayResultSet() Returns the option to expand or not expand the ResultSet of a column with data type ARRAY.
java.lang.Integer	getFetchSize() Retrieves the fetch size.
java.lang.String	getInitStatusGroup() Retrieves the initStatusGroup.
java.lang.Boolean	getJDBCConnection() Retrieves the JDBC connectivity type.
java.lang.String	getKeyStoreType() Retrieves the Key Store Type
java.lang.Boolean	getLLField() Retrieves the llField.
java.io.PrintWriter	getLogWriter() Retrieves the log writer for this ManagedConnectionFactory object.
java.lang.Integer	getMaxRows() Retrieves the max rows.
java.lang.String	getMetadataURL() Deprecated. getDatabaseName()
java.lang.String	getPassword() Retrieves the user password.
java.lang.Integer	getPortNumber() Retrieves the port number.
boolean	getRemoveInvalidCaseFields() Returns the option to whether to remove the map case fields that don't satisfy the DEPENDINGON field condition in the WHERE clause from the column's list in the result set.
java.lang.String	getSecureSocketProtocol() Retrieves the Secure Socket Protocol
boolean	getSsaOptimization() Returns the option to whether to optimize the SSA or not When set to true the SSA will be optimized to a fully qualified key if subfields of that key are provided.
java.lang.Boolean	getSSLConnection() Retrieves the SSL connectivity.
java.lang.String	getSslKeyMgrAlgorithm() Retrieves the SSL Key Store Manager Algorithm
java.lang.String	getSslKeyStoreLocation() Retrieves the SSL Key Store Location
java.lang.String	getSslKeyStorePassword() Retrieves the SSL Key Store Password
java.lang.String	getSslTrustMgrAlgorithm() Retrieves the SSL Trust Store Manager Algorithm
java.lang.String	getSslTrustStoreLocation() Retrieves the SSL Trust Store Location
java.lang.String	getSslTrustStorePassword() Retrieves the SSL Trust Store Password
java.lang.String	getUser() Retrieves the user name.
void	setCurrentSchema(java.lang.String currentSchema) Sets the current schema.
void	setDatabaseName(java.lang.String databaseName) Sets the name of the target IMS database to be accessed.
void	setDatastoreName(java.lang.String datastoreName) Sets the name of the IMS datastore to access.
void	setDatastoreServer(java.lang.String datastoreServer) Sets the name or IP address of the datastore server (IMS Connect).
void	setDriverType(java.lang.String driverType) Sets the type of driver to use to connect to the database.
void	setExpandArrayResultSet(boolean expandArrayResultSet) Sets the option to expand or not expand the ResultSet of a column with data type ARRAY.
void	setFetchSize(int fetchsize) Sets the fetch size.
void	setFlattenTables(boolean flattenTables)
void	setInitStatusGroup(java.lang.String initStatusGroup) When a connection is made and the PSB allocated, this property will indicate that the driver should automatically issue an INIT STATUS GROUPA or INIT STATUS GROUPB if a value of 'A' or 'B' is provided.
void	setJDBCConnection(boolean isJDBC) Sets the JDBC connectivity which indicates whether or not the connection the application receives is java.sql.Connection versus a javax.resource.cci.Connection.
void	setKeyStoreType(java.lang.String keyStoreType) Sets the Key Store Type
void	setLLField(boolean llField) Sets the llField property.
void	setLoginTimeout(int loginTimeout) Sets the loginTimeout.
void	setLogWriter(java.io.PrintWriter out) Sets the log writer for this ManagedConnectionFactory object to the given java.io.PrintWriter object.
void	setMaxRows(int maxRows) Sets the max rows.
void	setMetadataURL(java.lang.String metadataURL) Deprecated. setDatabaseName(String)
void	setPassword(java.lang.String password) Sets the user password.
void	setPoolConnections(boolean poolConnections) Enables connection pooling in a two-tier non-managed environment.
void	setPortNumber(int portNumber) Sets the port number to be used to communicate with IMS Connect.
void	setPreloadUserTypeConverters(boolean preloadUserTypeConverters)
void	setRemoveInvalidCaseFields(boolean removeInvalidCaseFields) Sets the option to whether to remove the map case fields that don't satisfy the DEPENDINGON field condition in the WHERE clause from the column's list in the result set.
void	setSecureSocketProtocol(java.lang.String secureSocketProtocol) Sets the Secure Socket Protocol
void	setSignedCompare(boolean signedCompare)
void	setSsaOptimization(boolean ssaOptimization) Sets the option to whether to optimize the SSA or not When set to true the SSA will be optimized to a fully qualified key if subfields of that key are provided.
void	setSSLConnection(boolean sslConnection) Sets SSL encryption on or off.
void	setSSLKeyMgrAlgorithm(java.lang.String sslKeyMgrAlgorithm) Sets the SSL Key Store Manager Algorithm
void	setSSLKeyStoreLocation(java.lang.String sslKeyStoreLocation) Sets the SSL Key Store Location
void	setSSLKeyStorePassword(java.lang.String sslKeyStorePassword) Sets the SSL Key Store Password
void	setSSLTrustMgrAlgorithm(java.lang.String sslTrustMgrAlgorithm) Sets the SSL Trust Store Manager Algorithm
void	setSSLTrustStoreLocation(java.lang.String sslTrustStoreLocation) Sets the SSL Trust Store Location
void	setSSLTrustStorePassword(java.lang.String sslTrustStorePassword) Sets the SSL Trust Store Password
void	setTreatInvalidDecimalAsNull(boolean treatInvalidDecimalAsNull)
void	setUser(java.lang.String user) Sets the user name

Methods inherited from class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

createConnectionFactory, createManagedConnection, equals, getApplicationName, getConnectionManager, getFlattenTables, getInvalidConnections, getLoginTimeout, getReturnResultOnStatusCodeGE, getRRSTransactional, getSignedCompare, getThreadIdentitySupport, getThreadSecurity, getTreatIncompleteFieldAsNull, getTreatInvalidDecimalAsNull, getUtclibpaths, hashCode, isManagedServer, isRRSLocalOption, matchManagedConnections, setApplicationName, setFetchSize, setFlattenTables, setLLField, setLoginTimeout, setMaxRows, setPortNumber, setReturnResultOnStatusCodeGE, setSignedCompare, setSSLConnection, setTreatIncompleteFieldAsNull, setTreatInvalidDecimalAsNull, setUtcLibPaths

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

DRIVER_TYPE_4

public static final java.lang.String DRIVER_TYPE_4

Constant indicating the driver is pure Java and implements the network protocol for the data source.

See Also:

Constant Field Values

DRIVER_TYPE_2

public static final java.lang.String DRIVER_TYPE_2

See Also:

Constant Field Values

DRIVER_TYPE_2_CTX

public static final java.lang.String DRIVER_TYPE_2_CTX

See Also:

Constant Field Values

Constructor Detail

IMSManagedConnectionFactory

public IMSManagedConnectionFactory()

Method Detail

createConnectionFactory

public java.lang.Object createConnectionFactory()
                                         throws javax.resource.ResourceException

Creates a ConnectionFactory instance. The ConnectionFactory instance is initialized with a default ConnectionManager object provided by the resource adapter.

Specified by:

createConnectionFactory in interface javax.resource.spi.ManagedConnectionFactory

Overrides:

createConnectionFactory in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

an Object that implements the ConnectionFactory interface

Throws:

javax.resource.ResourceException - if an error occurs during processing

setMetadataURL

public void setMetadataURL(java.lang.String metadataURL)

Deprecated. setDatabaseName(String)

Sets the location of the database metadata representing the target IMS database. The metadata URL is the fully qualified name of the Java metadata class generated by the IMS Explorer for Development. The URL must begin with class://

Overrides:

setMetadataURL in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

metadataURL - metadata url

setDatabaseName

public void setDatabaseName(java.lang.String databaseName)

Sets the name of the target IMS database to be accessed. If the metadata repository is the IMS catalog then the database name is the name of the PSB (program specification block) containing the database(s) to be accessed. If the metadata repository is the file system then the database name is the fully qualified name of the Java metadata class generated by the IMS Explorer for Development. In this case the name must begin with class://

Overrides:

setDatabaseName in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

databaseName - database name

setDatastoreName

public void setDatastoreName(java.lang.String datastoreName)

Sets the name of the IMS datastore to access. The datastore parameter must match either the name of the datastore defined to ODBM or be blank. The datastore name is defined in the ODBM CSLDCxxx PROCLIB member using either the DATASTORE (NAME=name) or ALIAS (NAME=aliasname) parameter. If the datastore value is left blank (or not supplied), IMS Connect will connect to any available instance of ODBM as it is assumed all datastores defined to ODBM are data shared.

Overrides:

setDatastoreName in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

datastoreName - IMS datastore name

setDatastoreServer

public void setDatastoreServer(java.lang.String datastoreServer)

Sets the name or IP address of the datastore server (IMS Connect). You can provide either the host name (for example, dev123.svl.ibm.com) or the IP address (for example, 192.166.0.2).

Overrides:

setDatastoreServer in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

datastoreServer - name or IP address of the datastore server (IMS Connect)

setPortNumber

public void setPortNumber(int portNumber)

Sets the port number to be used to communicate with IMS Connect. The port number is defined using the DRDAPORT parameter on the ODACCESS statement in the integrated IMS Connect configuration PROCLIB member.

By default, the port number is 8888.

Parameters:

portNumber - port number

setLoginTimeout

public void setLoginTimeout(int loginTimeout)

Sets the loginTimeout. This value represents the number of seconds to wait for TCP/IP socket creation or server response before timing out.

By default, the value is 0, which means the driver will wait indefinitely for a socket connection creation or server response.

Parameters:

loginTimeout -

setDriverType

public void setDriverType(java.lang.String driverType)

Sets the type of driver to use to connect to the database.

Overrides:

setDriverType in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

driverType - Only 4 is currently supported.

setSSLConnection

public void setSSLConnection(boolean sslConnection)

Sets SSL encryption on or off.

Parameters:

sslConnection - Set to true to turn SSL encryption on.

setSSLTrustStoreLocation

public void setSSLTrustStoreLocation(java.lang.String sslTrustStoreLocation)

Sets the SSL Trust Store Location

Overrides:

setSSLTrustStoreLocation in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

sslTrustStoreLocation - The SSL Trust Store Location

setSSLTrustStorePassword

public void setSSLTrustStorePassword(java.lang.String sslTrustStorePassword)

Sets the SSL Trust Store Password

Overrides:

setSSLTrustStorePassword in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

sslTrustStorePassword - The SSL Trust Store Password

setSSLTrustMgrAlgorithm

public void setSSLTrustMgrAlgorithm(java.lang.String sslTrustMgrAlgorithm)

Sets the SSL Trust Store Manager Algorithm

Overrides:

setSSLTrustMgrAlgorithm in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

sslTrustMgrAlgorithm - The SSL Trust Store Manager Algorithm

setSSLKeyStoreLocation

public void setSSLKeyStoreLocation(java.lang.String sslKeyStoreLocation)

Sets the SSL Key Store Location

Overrides:

setSSLKeyStoreLocation in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

sslKeyStoreLocation - The SSL Key Store Location

setSSLKeyStorePassword

public void setSSLKeyStorePassword(java.lang.String sslKeyStorePassword)

Sets the SSL Key Store Password

Overrides:

setSSLKeyStorePassword in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

sslKeyStorePassword - The SSL Key Store Password

setSSLKeyMgrAlgorithm

public void setSSLKeyMgrAlgorithm(java.lang.String sslKeyMgrAlgorithm)

Sets the SSL Key Store Manager Algorithm

Overrides:

setSSLKeyMgrAlgorithm in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

sslKeyMgrAlgorithm - The SSL Key Store Manager Algorithm

setKeyStoreType

public void setKeyStoreType(java.lang.String keyStoreType)

Sets the Key Store Type

Overrides:

setKeyStoreType in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

keyStoreType - The Key Store Type. Valid values include "JKS" or "PKCS12".

setSecureSocketProtocol

public void setSecureSocketProtocol(java.lang.String secureSocketProtocol)

Sets the Secure Socket Protocol

Overrides:

setSecureSocketProtocol in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

secureSocketProtocol - The Secure Socket Protocol Valid values include "SSL", "SSLv3", "TLSv1.1", "TLSv1.2", etc.

setUser

public void setUser(java.lang.String user)

Sets the user name

Overrides:

setUser in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

user - User name.

setPassword

public void setPassword(java.lang.String password)

Sets the user password.

Overrides:

setPassword in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

password - User password value

setFetchSize

public void setFetchSize(int fetchsize)

Sets the fetch size.

Parameters:

fetchsize - Fetch size value

setMaxRows

public void setMaxRows(int maxRows)

Sets the max rows.

Parameters:

maxRows - Max rows value

setTreatInvalidDecimalAsNull

public void setTreatInvalidDecimalAsNull(boolean treatInvalidDecimalAsNull)

setFlattenTables

public void setFlattenTables(boolean flattenTables)

setPreloadUserTypeConverters

public void setPreloadUserTypeConverters(boolean preloadUserTypeConverters)

Overrides:

setPreloadUserTypeConverters in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

setSignedCompare

public void setSignedCompare(boolean signedCompare)

setCurrentSchema

public void setCurrentSchema(java.lang.String currentSchema)

Sets the current schema.

Overrides:

setCurrentSchema in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

currentSchema - Current schema value

setLLField

public void setLLField(boolean llField)

Sets the llField property.

Parameters:

llField - llField value

setJDBCConnection

public void setJDBCConnection(boolean isJDBC)

Sets the JDBC connectivity which indicates whether or not the connection the application receives is java.sql.Connection versus a javax.resource.cci.Connection. The default is false.

Parameters:

isJDBC - true indicates java.sql.Connection, false indicates javax.resource.cci.Connection

setPoolConnections

public void setPoolConnections(boolean poolConnections)

Enables connection pooling in a two-tier non-managed environment. The default value is false.

Parameters:

poolConnections -

setInitStatusGroup

public void setInitStatusGroup(java.lang.String initStatusGroup)

When a connection is made and the PSB allocated, this property will indicate that the driver should automatically issue an INIT STATUS GROUPA or INIT STATUS GROUPB if a value of 'A' or 'B' is provided. The default will not issue an INIT STATUS GROUP call.

Overrides:

setInitStatusGroup in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

initStatusGroup -

setExpandArrayResultSet

public void setExpandArrayResultSet(boolean expandArrayResultSet)

Sets the option to expand or not expand the ResultSet of a column with data type ARRAY.

When set to true the array result set expands the sub-elements of the array into 1 or more columns depending on the number of fields defined within the array.

When set to false (default) the array result set returns a result set of exactly 2 columns. Column 1 is the index and column 2 is a Struct object that contains accessors for fields within that array element.

Overrides:

setExpandArrayResultSet in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

expandArrayResultSet -

setSsaOptimization

public void setSsaOptimization(boolean ssaOptimization)

Sets the option to whether to optimize the SSA or not

When set to true the SSA will be optimized to a fully qualified key if subfields of that key are provided.

When set to false (default) the SSA will not be optimized.

Overrides:

setSsaOptimization in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

ssaOptimization -

setRemoveInvalidCaseFields

public void setRemoveInvalidCaseFields(boolean removeInvalidCaseFields)

Sets the option to whether to remove the map case fields that don't satisfy the DEPENDINGON field condition in the WHERE clause from the column's list in the result set.

When set to true, only the valid map case fields will be returned in the result set.

When set to false (default) the result set will contain all map case fields.

Overrides:

setRemoveInvalidCaseFields in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

removeInvalidCaseFields -

getJDBCConnection

public java.lang.Boolean getJDBCConnection()

Retrieves the JDBC connectivity type.

Overrides:

getJDBCConnection in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

true indicates that the connection the application receives will be a java.sql.Connection. false indicates that the connection will be a javax.resource.cci.Connection.

getMetadataURL

public java.lang.String getMetadataURL()

Deprecated. getDatabaseName()

Retrieves the URL of the database metadata representing the target IMS database.

Overrides:

getMetadataURL in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

the metadata URL

getDatabaseName

public java.lang.String getDatabaseName()

Retrieves the name of the target IMS database.

Overrides:

getDatabaseName in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

the database name

getDatastoreName

public java.lang.String getDatastoreName()

Retrieves name of the IMS datastore.

Overrides:

getDatastoreName in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

the datastore name

getDatastoreServer

public java.lang.String getDatastoreServer()

Retrieves the name or IP address of your datastore server (IMS Connect).

Overrides:

getDatastoreServer in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

the name or IP address of the datastore server (IMS Connect)

getPortNumber

public java.lang.Integer getPortNumber()

Retrieves the port number.

Overrides:

getPortNumber in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

the port number for this connection.

getDriverType

public java.lang.String getDriverType()

Retrieves the database connectivity method.

Overrides:

getDriverType in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

the database connectivity method

getSSLConnection

public java.lang.Boolean getSSLConnection()

Retrieves the SSL connectivity.

Overrides:

getSSLConnection in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

true indicates SSL will be used, false indicates otherwise

getSslTrustStoreLocation

public java.lang.String getSslTrustStoreLocation()

Retrieves the SSL Trust Store Location

Overrides:

getSslTrustStoreLocation in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

The SSL Trust Store Location

getSslTrustStorePassword

public java.lang.String getSslTrustStorePassword()

Retrieves the SSL Trust Store Password

Overrides:

getSslTrustStorePassword in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

The SSL Trust Store Password

getSslTrustMgrAlgorithm

public java.lang.String getSslTrustMgrAlgorithm()

Retrieves the SSL Trust Store Manager Algorithm

Overrides:

getSslTrustMgrAlgorithm in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

The SSL Trust Store Manager Algorithm

getSslKeyStoreLocation

public java.lang.String getSslKeyStoreLocation()

Retrieves the SSL Key Store Location

Overrides:

getSslKeyStoreLocation in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

The SSL Key Store Location

getSslKeyStorePassword

public java.lang.String getSslKeyStorePassword()

Retrieves the SSL Key Store Password

Overrides:

getSslKeyStorePassword in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

The SSL Key Store Password

getSslKeyMgrAlgorithm

public java.lang.String getSslKeyMgrAlgorithm()

Retrieves the SSL Key Store Manager Algorithm

Overrides:

getSslKeyMgrAlgorithm in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

The SSL Key Store Manager Algorithm

getKeyStoreType

public java.lang.String getKeyStoreType()

Retrieves the Key Store Type

Overrides:

getKeyStoreType in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

The Key Store Type

getSecureSocketProtocol

public java.lang.String getSecureSocketProtocol()

Retrieves the Secure Socket Protocol

Overrides:

getSecureSocketProtocol in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

The Secure Socket Protocol

getUser

public java.lang.String getUser()

Retrieves the user name.

Overrides:

getUser in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

the user name for this connection.

getPassword

public java.lang.String getPassword()

Retrieves the user password.

Overrides:

getPassword in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

user password value for this connection

getFetchSize

public java.lang.Integer getFetchSize()

Retrieves the fetch size.

Overrides:

getFetchSize in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

fetch size value for this connection

getMaxRows

public java.lang.Integer getMaxRows()

Retrieves the max rows.

Overrides:

getMaxRows in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

max rows value for this connection

getCurrentSchema

public java.lang.String getCurrentSchema()

Retrieves the current schema.

Overrides:

getCurrentSchema in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

current schema value for this connection

getLLField

public java.lang.Boolean getLLField()

Retrieves the llField.

Overrides:

getLLField in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

llField value for this connection

getInitStatusGroup

public java.lang.String getInitStatusGroup()

Retrieves the initStatusGroup.

Overrides:

getInitStatusGroup in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

initStatusGroup value for this connection

getExpandArrayResultSet

public boolean getExpandArrayResultSet()

Returns the option to expand or not expand the ResultSet of a column with data type ARRAY.

When set to true the array result set expands the sub-elements of the array into 1 or more columns depending on the number of fields defined within the array.

When set to false (default) the array result set returns a result set of exactly 2 columns. Column 1 is the index and column 2 is a Struct object that contains accessors for fields within that array element.

Overrides:

getExpandArrayResultSet in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

expandArrayResultSet -

getSsaOptimization

public boolean getSsaOptimization()

Returns the option to whether to optimize the SSA or not

When set to true the SSA will be optimized to a fully qualified key if subfields of that key are provided.

When set to false (default) the SSA will not be optimized.

Overrides:

getSsaOptimization in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

ssaOptimization -

getRemoveInvalidCaseFields

public boolean getRemoveInvalidCaseFields()

Returns the option to whether to remove the map case fields that don't satisfy the DEPENDINGON field condition in the WHERE clause from the column's list in the result set.

When set to true, only the valid map case fields will be returned in the result set.

When set to false (default) the result set will contain all map case fields.

Overrides:

getRemoveInvalidCaseFields in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

boolean removeInvalidCaseFields

setLogWriter

public void setLogWriter(java.io.PrintWriter out)

Sets the log writer for this ManagedConnectionFactory object to the given java.io.PrintWriter object.

The log writer is a character output stream to which all logging and tracing messages for this data source will be printed. This includes messages printed by the methods of this object, messages printed by methods of other objects manufactured by this object, and so on.

Specified by:

setLogWriter in interface javax.resource.spi.ManagedConnectionFactory

Overrides:

setLogWriter in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Parameters:

out - the new log writer; to disable logging, set to null.

getLogWriter

public java.io.PrintWriter getLogWriter()

Retrieves the log writer for this ManagedConnectionFactory object. The log writer is a character output stream to which all logging and tracing messages for this data source will be printed. This includes messages printed by the methods of this object, messages printed by methods of other objects manufactured by this object, and so on. The log writer is initially null; in other words, the default is for logging to be disabled.

Specified by:

getLogWriter in interface javax.resource.spi.ManagedConnectionFactory

Overrides:

getLogWriter in class com.ibm.ims.db.spi.ManagedConnectionFactoryImpl

Returns:

the log writer for this data source or null if logging is disabled