Common Ibm Data Server Driver For Jdbc And Sqlj Properties For Ids And Db2 Database For Linux, Unix, And Windows - IBM DB2 Manual

|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Common IBM Data Server Driver for JDBC and SQLJ
properties for IDS and DB2 Database for Linux, UNIX, and
Windows
for JDBC and SQLJ uses transport objects and a global transport objects pool to
support the connection concentrator and Sysplex workload balancing. There is
one transport object for each physical connection to the data source.
The data type of this property is int.
The maxTransportObjects value is ignored if the enableConnectionConcentrator
or enableSysplexWLB properties are not set to enable the use of the connection
concentrator or Sysplex workload balancing.
If the maxTransportObjects value has not been reached, and a transport object
is not available in the global transport objects pool, the pool creates a new
transport object. If the maxTransportObjects value has been reached, the
application waits for the amount of time that is specified by the
db2.jcc.maxTransportObjectWaitTime configuration property. After that amount
of time has elapsed, if there is still no available transport object in the pool, the
pool throws an SQLException.
maxTransportObjects does not override the db2.jcc.maxTransportObjects
configuration property. maxTransportObjects has no effect on connections from
other DataSource objects. If the maxTransportObjects value is larger than the
db2.jcc.maxTransportObjects value, maxTransportObjects does not increase the
db2.jcc.maxTransportObjects value.
The default value for maxTransportObjects is -1, which means that the number
of transport objects for the DataSource is limited only by the
db2.jcc.maxTransportObjects value for the driver.
retrieveMessagesFromServerOnGetMessage
Specifies whether JDBC SQLException.getMessage or SQLWarning.getMessage
calls cause the IBM Data Server Driver for JDBC and SQLJ to invoke a DB2 for
z/OS stored procedure that retrieves the message text for the error. The data
type of this property is boolean. The default is false, which means that the full
message text is not returned to the client.
For example, if retrieveMessagesFromServerOnGetMessage is set to true, a
message similar to this one is returned by SQLException.getMessage after an
attempt to perform an SQL operation on nonexistent table
ADMF001.NO_TABLE:
ADMF001.NO_TABLE IS AN UNDEFINED NAME. SQLCODE=-204,
SQLSTATE=42704, DRIVER=3.50.54
If retrieveMessagesFromServerOnGetMessage is set to false, a message similar
to this one is returned:
DB2 SQL Error: SQLCODE=-204, SQLSTATE=42704, DRIVER=3.50.54
An alternative to setting this property to true is to use the IBM Data Server
Driver for JDBC and SQLJ-only DB2Sqlca.getMessage method in applications.
Both techniques result in a stored procedure call, which starts a unit of work.
Some of the IBM Data Server Driver for JDBC and SQLJ properties apply to IBM
Informix Dynamic Server (IDS) and DB2 Database for Linux, UNIX, and Windows
database servers.
Properties that apply to IDS and DB2 Database for Linux, UNIX, and Windows are:
Chapter 7. JDBC and SQLJ reference information
225