skip to main content
DataDirect Connect Drivers : DB2 Driver : Failover Properties
  
Failover Properties
The following table summarizes the connection properties that control how failover works with the DB2 driver. See Connection Properties for details about configuring each property.
Table 30. Summary: Failover Properties for the DB2 Driver
Property
Description
AlternateServers
One or multiple alternate database servers. An IP address or server name identifying each server is required. Port number and supported connection properties (DatabaseName or LocationName) are optional. If the port number is unspecified, the port specified for the primary server is used. If a port number is not specified for the primary server, a default port number of 50000 is used.
ConnectionRetryCount
Number of times the driver retries the primary database server, and if specified, alternate servers until a successful connection is established. The default is 5.
ConnectionRetryDelay
Wait interval, in seconds, between connection retry attempts when the ConnectionRetryCount property is set to a positive integer. The default is 1.
DatabaseName
Name of the database to which you want to connect.
FailoverGranularity
Determines whether the driver fails the entire failover process or continues with the process if exceptions occur while trying to reestablish a lost connection. The default is nonAtomic (the driver continues with the failover process and posts any exceptions on the statement on which they occur).
FailoverMode
The failover method you want the driver to use. The default is connect (connection failover is used).
FailoverPreconnect
Specifies whether the driver tries to connect to the primary and an alternate server at the same time. The default is false (the driver tries to connect to an alternate server only when failover is caused by an unsuccessful connection attempt or a lost connection).
LoadBalancing
Sets whether the driver will use client load balancing in its attempts to connect to the database servers (primary and alternate). If client load balancing is enabled, the driver uses a random pattern instead of a sequential pattern in its attempts to connect. The default is false (client load balancing is not used).
PortNumber
Port listening for connections on the primary database server. This property is supported only for data source connections. The default port number is 50000.
ServerName
IP address or server name of the primary database server. This property is supported only for data source connections.
See Using Failover and Using Client Load Balancing for overviews of failover and client load balancing.