Connection Failover Attributes
- Last Updated: May 12, 2026
- 2 minute read
- OpenAccess SDK
- Version 8.1
- Documentation
The following table summarizes the connection attributes that control how connection failover works with the ODBC Client. See Specifying ODBC Connection Attributes for details about configuring each property.
| Connection Attribute | Characteristic |
| AlternateServers | A list of alternate OpenAccess SDK servers to which the ODBC Client will attempt to connect if the primary OpenAccess SDK server is unavailable. A port number and an IP address or server name identifying each server are required. Note: If the primary OpenAccess SDK server is an LDAP server, each alternate server must be an LDAP server. |
| ConnectionRetryCount | Number of times the ODBC Client retries the primary OpenAccess SDK 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. |
| Host | The TCP/IP address or server name of primary OpenAccess SDK server. IMPORTANT: If LDAP is enabled, this identifies the TCP/IP address of the LDAP server. This can also be a list of LDAP servers separated by a blank space (for example, “ld1.foo.com ld2.foo.com ld3.foo.com”). If the first LDAP server in the list does not respond, the ODBC Client will try to connect to the next LDAP server in the list. |
| LoadBalancing | Sets whether the ODBC Client will use client load balancing in its attempts to connect to the list of OpenAccess SDK servers (primary and alternate). If client load balancing is enabled, the ODBC Client uses a random pattern instead of a sequential pattern in its attempts to connect. The default is false (client load balancing is disabled). |
| Port | The TCP/IP port on which the primary OpenAccess SDK server is listening. Note: If LDAP is enabled, this identifies the TCP/IP port on which the LDAP server is listening. |