Configuring Java CAPS Environment Components for Database Adapters

Outbound Sybase Adapter

The Outbound Sybase Adapter includes the following configuration sections:

JDBC Connector Settings

The following Parameter Settings are used by the external database.

Table 48 Outbound Sybase Adapter—JDBC Connector Settings

Name 

Description 

Required Value 

Description

The description of the database. 

A valid string. 

ServerName

This setting specifies the host name of the external database server. 

Any valid string. 


Note –

The Sybase Adapter does not support using “localhost” as the server name.


PortNumber

Specifies the I/O port number on which the server is listening for connection requests. 

A valid port number. The default is 4100.

DatabaseName

Specifies the name of the database instance. 

Any valid string. 

User

Specifies the user name the adapter uses to connect to the database. 

Any valid string. 

Password

Specifies the password used to access the database. 

Any valid string. 

DriverProperties

The DataSource implementation may need to execute additional methods to assure a successful run. The additional methods will need to be identified in the Driver Properties. 

The delimiter set by the user. For more information, see the Delimiter property below. 

Valid delimiters are: 

 

“<method-name-1>#<param-1>#<param-2>#.........<param-n>##<method-name-2>#<param-1>#<param-2>#........<param-n>##......##”.

For example: to execute the method setSpyAttributes, give the method a String for the URL “setSpyAttribute#<url>##”. 


Note –

The setSpyAttributes (for Data Direct drivers) that are contained in the following examples (between the last set of double octothorps [##] within each example), are used for debugging purposes and need not be used on every occasion.


Optional—if you are using Spy Log: 

 

“setURL#jdbc:Seebeyond:Sybase://<server>:4100;DatabaseName=<database>##setSpyAttributes#log=(file)c:/temp/spy.log;logTName=yes##”

Delimiter

This is the delimiter character to be used in the DriverProperties prompt. 

The default is #. See the DriverProperties property above for more information on how the default value is used.

MinPoolSize

Specifies the minimum number of physical connections the pool should keep available at all times. 0 (zero) indicates that there should be no physical connections in the pool and the new connections should be created as needed. 

If the pool size is too small, you may experience a longer connection time due to the existing number of physical connections. 

A connection that stays in the pool allows transactions to use it via a logical connection which is faster. 

A valid numeric value. The default is 0.

MaxPoolSize

Specifies the maximum number of physical connections the pool should keep available at all times. 0 (zero) indicates that there is no maximum. 

The pool size you set depends on the transaction volume and response time of the application. If the pool size is too big, you may end up with too many connections with the database. 

A valid numeric value. The default is 10.

MaxIdleTime

Specifies the maximum number of seconds that a physical connection may remain unused before it is closed. 0 (zero) indicates that there is no limit. 

A valid numeric value. The default is 0.

Connection Retry Settings

The following Parameter Settings are used by the external database.

Table 49 Outbound Sybase Adapter—Connection Retry Settings

Name 

Description 

Required Value 

ConnectionRetries

Specifies the number of retries to establish a connection upon failure to acquire one. 

A valid numeric value. The default is 0.

ConnectionRetryInterval

Specifies the milliseconds of pause before each attempt to access the database. This setting is used in conjunction with the ’Connection Retries’ setting. 

For example: In the event that the adapter cannot connect to the Database, the adapter will try to reconnect to the database 10 times in 5 seconds intervals when the Connection Retries is 10 and the Connection Retry Interval is 5000. 

A valid numeric value. The default is 1000.