ODBC Driver for SAP Sybase Adaptive Server Enterprise

Connection Options

SAP Sybase Adaptive Server Enterprise Connection Options

The following table describes the options that you can include in the connection string for SAP Sybase Adaptive Server Enterprise:
Option Description

Server

Serves to supply the server name for login.

Port

Used to specify the port number for the connection. 5000 by default.

Username

Used to supply a user name for login.

Password

Used to supply a password for login.

Database

Used to set the name of the database

ConnectionTimeout

Used to specify the time in seconds before an attempt to make a connection is considered unsuccessful.

IPVersion

Used to specify the version of the Internet Protocol. IPv4 and IPv6 are available. The IPv4 + IPv6 value allows to check for available protocol versions and use the first available automatically.

Advanced Settings

Option Description

Empty strings as NULL

To retrieve metadata, not all parameters according to MSDN can accept a null value. If NULL, the driver should return an error. But some 3rd-party tools pass NULL to the parameters. These options should be enabled for compatibility with such tools.

Allow NULL strings

RegionalNumberSettings

Enables using local regional settings when converting numbers to string.

RegionalDateTimeSettings

Enables using local regional settings when converting dates and times to string.

AllowFixedTypes

Adaptive Server Enterprise cannot distinguish SQL_CHAR from SQL_VARCHAR, SQL_WCHAR from SQL_WVARCHAR, and SQL_BINARY from SQL_VARBINARY on preparing an SQL statement. It can break compatibility with some third-party tools. So the driver always returns SQL_VARCHAR instead of SQL_CHAR, SQL_WVARCHAR instead of SQL_WCHAR, and SQL_VARBINARY instead of SQL_BINARY in metadata. To change this behavior and allow returning fixed types in metadata, this parameter should be set to True.

Example Connection String

Login Prompt=False;User ID=sa;Server=ASEserver;Data Source=master;Port=5000;


SSL Connection Options

Option Description

Use SSL

Enables or disables SSL for connection.

SSL CACert

Holds the pathname to the certificate authority file.

SSL Cert

Holds the pathname to the certificate file.

SSL CipherList

Holds the list of allowed ciphers to use for SSL encryption.

SSL Key

Holds the pathname to the key file.

Example connection string using SSL

Login Prompt=False;User ID=sa;Server=ASEserver;Data Source=master;Port=5000;Use SSL=true;SSL CACert=c:\cacert.pem;SSL Cert=c:\client-cert.pem;SSL Key=c:\client-key.pem;SSL CipherList=ALL


SSH Connection Options

Option Description

Use SSH

Enables or disables SSH tunneling.

SSH Host name

Holds the host name or IP address of the SSH server to connect to.

SSH Port

Used to specify the port number for SSH connection.

SSH User Name

Sets the SSH user name for authentication.

SSH Password

Sets the SSH user password for authentication.

SSH Client Key

Used to specify the path to the file containing the SSH Private Key.

If the authentication by key is used, the user must have his pair of keys. The public key should be transferred to the server, while the private key will be used by the client to sign data, that will be used by server to authenticate the user. The server verifies the specified user name and Private Key - and if the Server Key corresponds to this user, connection may be established.

SSH Server Key

Used to specify the path to the file that contains SSH Public Key.

Example connection string using SSH

Login Prompt=False;User ID=sa;Server=ASEserver;Data Source=master;Port=5000;Use SSH=true;SSH Hostname=localhost;SSH Port=22;SSH Username=SSHUser;SSH Password=SSHPass;SSH Client Key='C:\User\...\PrivateKey.pem';SSH Server Key='C:\User\...\PublicKey.pem';


HTTP Connection Options

Option Description

Use Http

Enables or disables HTTP tunneling.

Http Url

Holds the url of the tunneling PHP script.

Http Username

Holds the user name for HTTP authorization.

Http Password

Holds the password for HTTP authorization.

Proxy Host Name

If you are using Proxy for connection to your network, specify the Proxy server address in this option. To learn your Proxy server address, open Control Panel->Internet Options->Connections->LAN settings.

Proxy Port

Used to specify the port number for TCP/IP connection with proxy server.

Proxy Username

Holds the proxy server account name.

Proxy Password

Holds the password for the proxy server account.

Example connection string using HTTP Tunnel

Login Prompt=False;User ID=sa;Server=ASEserver;Data Source=mater;Port=5000;Use Http=true;Url=http://server/tunnel.php;Http Username=HttpUser;Http Password=HttpPassword;

Example connection string using Proxy and HTTP Tunnel

Login Prompt=False;User ID=sa;Server=ASEserver;Data Source=192.168.0.10;Port=5000;Use Http=true;Url=http://server/tunnel.php;Proxy Hostname=10.0.0.1;Proxy Port=808;Proxy User=ProxyUser;Proxy Password=ProxyPassword;
© 2015-2017 Devart. All Rights Reserved. Request Support ODBC Forum Provide Feedback