The following connection option descriptions are listed alphabetically by the GUI name that appears on the driver Setup dialog box. The connection string attribute name, along with its short name, is listed immediately underneath the GUI name.

In most cases, the GUI name and the attribute name are the same; however, some exceptions exist. If you need to look up an option by its connection string attribute name, please refer to the alphabetical table of connection string attribute names.

Also, a few connection string attributes do not have equivalent options that appear on the GUI. They are in the list of descriptions alphabetically by their attribute names.

Note: The driver does not support specifying values for the same connection option multiple times in a connection string or DSN. If a value is specified using the same attribute multiple times or using both long and short attributes, the connection may fail or the driver may not behave as intended.

The following tables provide a summary of supported connection options by functionality, including their attribute names, short names, and default values.

Required options

Failover options

Additional options

Required options

The following table summarizes options that are required for authenticating to the server.

Table 1. Required options
Attribute (Short Name) Default
Database (DB) No default value
DataSourceName (DSN) No default value
Description (n/a) No default value
HostName (HOST) No default value
LoginID (UID) No default value
Password (PWD) No default value
PortNumber (PORT) No default value
ServerName (SRVR) No default value

Failover options

The following table summarizes the connection options that control how failover works with the driver.
Table 2. Failover options
Attribute (Short Name) Default
AlternateServers (ASRV) No default value
ConnectionRetryCount (CRC) 0
ConnectionRetryDelay (CRD) 3
LoadBalancing (LB) 0 (Disabled)

Additional options

The following table summarizes additional options.

Table 3. Additional options
Attribute (Short Name) Default
ApplicationUsingThreads (AUT) 1 (Enabled)
CancelDetectInterval (CDI) 0 (None)
IANAAppCodePage (IACP) UNIX/Linux only 4 (ISO 8559-1 Latin-1)
TrimBlankFromIndexName (TBFIN)

1 (Enabled)
UseDelimitedIdentifier (UDI)

0 (Disabled)