You are on page 1of 53

Contents I

Table of Contents
Part I What's New 1

Part II General Information 1
1 Overview
................................................................................................................................... 2
2 Features
................................................................................................................................... 3
3 Compatibility
................................................................................................................................... 5
4 Requirements
................................................................................................................................... 6
5 Licensing
................................................................................................................................... 6
6 Getting
...................................................................................................................................
Support 10

Part III Using ODBC Driver 11
1 Installation
................................................................................................................................... 12
Window s .......................................................................................................................................................... 12
MacOS .......................................................................................................................................................... 15
Linux .......................................................................................................................................................... 17
2 Connecting
...................................................................................................................................
to ASE 24
3 Connection
...................................................................................................................................
Options 27
4 Secure
...................................................................................................................................
Connections 30
.......................................................................................................................................................... 30
SSL Connection
.......................................................................................................................................................... 33
SSH Connection
.......................................................................................................................................................... 0
HTTP Tunnelling
5 Product
...................................................................................................................................
Registration 36
..........................................................................................................................................................
Driver Activation During Installation 36
..........................................................................................................................................................
Driver Activation After Installation 38
Where to See..........................................................................................................................................................
the License Inform ation? 41
6 Supported
...................................................................................................................................
Data Types 42
7 Supported
...................................................................................................................................
ODBC API Functions 43

Index 0

© 2016 Enter your company name

I

1 ODBC Driver for ASE

1 What's New

26-Oct-16 New features in ODBC Driver for SAP Sybase
Adaptive Server Enterprise 1.1
Support for IPv6 protocol is added
Compatibility with MS Visual Studio
Compatibility with MS FoxPro is improved
Compatibility with MapInfo is improved
Compatibility with Libre Office is improved
Compatibility with Qlik is improved
Compatibility with Delphi & C++Builder is improved
MS Access linked tables support is improved

05-Apr-16 New features in ODBC Driver for SAP Sybase
Adaptive Server Enterprise 1.0
First release of ODBC Driver for SAP Sybase Adaptive Server Enterprise
Windows is supported
Linux is supported
Mac OS X is supported
© 2015-2016
Devart. All Rights Request Support ODBC Forum Provide Feedback
Reserved.

2 General Information

1. Overview
2. Features
3. Compatibility
4. Requirements
5. Licensing
6. Getting Support
© 2015-2016
Devart. All Rights Request Support ODBC Forum Provide Feedback
Reserved.

© 2016 Enter your company name

General Information 2

2.1 Overview
ODBC Driver for SAP Sybase Adaptive Server Enterprise provides high-performance and
feature-rich connectivity solution for ODBC-based applications to access SAP Sybase
Adaptive Server Enterprise databases from Windows, Linux - both 32-bit and 64-bit.

Full support for standard ODBC API functions and data types implemented in our driver
makes interaction of your database applications with SAP Sybase Adaptive Server Enterprise
fast, easy and extremely handy.

Direct connection
Database applications based on our solution get an opportunity to establish connection to
SAP Sybase Adaptive Server Enterprise in Direct Mode. Direct Mode gives your applications
an unrivaled advantage - connection to SAP Sybase Adaptive Server Enterprise databases
directly via TCP/IP. That improves performance of your applications, their quality, reliability
and especially the deployment process, since there is no need to supply additional client
software together with your application.

Compatibility
ODBC Driver for SAP Sybase Adaptive Server Enterprise supports the following versions of
Adaptive Server Enterprise:
SAP Adaptive Server Enterprise 16.0 and higher
Sybase Adaptive Server Enterprise 12.0 and higher

© 2016 Enter your company name

3 ODBC Driver for ASE

© 2015-2016
Devart. All Rights Request Support ODBC Forum Provide Feedback
Reserved.

2.2 Features

Direct Connection
Database applications based on our solution get an opportunity to establish connection to
ASE directly via TCP/IP. That improves performance of your applications, their quality,
reliability and especially the deployment process, since there is no need to supply additional
client software together with your application.

ODBC Conformance
Our ODBC driver provides full support for common ODBC interface:
ODBC Data Types support
ODBC API Functions support
In addition, we provide support for Advanced Connection Stringparameters. Thus allowing any
desktop and web applications to connect to ASE from various environments and platforms,
that support ODBC.

© 2016 Enter your company name

General Information 4

Development Platforms Variety
ODBC Driver for SAP Sybase Adaptive Server Enterprise doesn't limit your choice of the
development platform and environment. The driver installations are available for various
operational systems and platforms. The current version supports Windows, both 32-bit and
64-bit. So you can develop both 32-bit and 64-bit cross-platform applications.

DB Compatibility
ODBC Driver for SAP Sybase Adaptive Server Enterprise supports the following versions of
Adaptive Server Enterprise:
SAP Adaptive Server Enterprise 16.0 and higher
Sybase Adaptive Server Enterprise 12.0 and higher

High Performance
All our products are designed to help you write high-performance, lightweight data access
layers, therefore they use advanced data access algorithms and techniques of optimization.

© 2016 Enter your company name

32-bit and 64-bit FreeBSD coming soon Verified Compatibility With 3rd-Party Data Tools Microsoft Visual Studio © 2016 Enter your company name . and much more. 32-bit and 64-bit (including Windows Terminal Server) MacOS. user engagement and interaction.0 and higher Supported Target Platforms Windows. frequent builds with bug fixes. 32-bit and 64-bit Linux. 5 ODBC Driver for ASE Support Visit our Support page to get instant support from experienced professionals. 2. fast and detailed responses.3 Compatibility ASE Compatibility ODBC Driver for SAP Sybase Adaptive Server Enterprise supports the following database servers: ASE versions Support SAP Adaptive Server Enterprise 16.0 and higher Sybase Adaptive Server Enterprise 12. © 2015-2016 Devart. All Rights Request Support ODBC Forum Provide Feedback Reserved.

5 Licensing ODBC Driver License Agreement -------------------------------------------------- PLEASE READ THIS LICENSE AGREEMENT CAREFULLY. 2. All Rights Request Support ODBC Forum Provide Feedback Reserved. © 2015-2016 Devart. All Rights Request Support ODBC Forum Provide Feedback Reserved. 2. General Information 6 Microsoft SQL Server Management Studio Microsoft SQL Server Integration Services Microsoft SQL Server Data Tools Microsoft Office Microsoft Visual FoxPro Crystal Reports ClikView PHP Python © 2015-2016 Devart. BY INSTALLING OR USING © 2016 Enter your company name .4 Requirements The following few requirements must be met in order to use ODBC Driver for SAP Sybase Adaptive Server Enterprise: Important condition is that only one ODBC Driver for SAP Sybase Adaptive Server Enterprise version can be installed on the PC in order to avoid incompatibility.

If more than one person can simultaneously use the computer where you plan to install the product.YOU INDICATE ACCEPTANCE OF AND AGREE TO BECOME BOUND BY THE TERMS AND CONDITIONS OF THIS LICENSE. demos.the "Desktop License" allows you to install and use the Software on a single desktop computer. 1. © 2016 Enter your company name . INTRODUCTION This Devart end-user license agreement ("Agreement") is a legal agreement between you (either an individual person or a single legal entity) and Devart. 1.provided it is used by 1 (one) legal entity in accordance with this Agreement.2.provided it is accessed by more than one person at a time.the "Server License" allows you to install and use the Software on a single server. but is not limited to. either directly or remotely.make one copy of the Software for archival purposes only.develop and test Applications with the Software. you are also entitled to:. If you are a legally licensed user. LICENSE 1. subject to the Limitations below. either directly or remotely. and online or electronic documentation contained in this installation file. DO NOT INSTALL OR USE THIS SOFTWARE AND PROMPTLY RETURN IT TO DEVART. A Desktop License is valid for one single desktop installation. and desktop workstations.1. subject to all limitations. for the use of the ODBC Driver software application.batch servers. not sold. for sole purposes only in accordance with this Agreement. provided it is accessed by no more than one person at a time. Web servers. depending on the license type specified in the registration letter you have received from Devart upon purchase of the Software:. or copy the Software onto the hard disk of your computer and retain the original for archival purposes.This definition includes. restrictions. . For the purpose of this Agreement. intermediate files. the software program(s) and supporting documentation will be referred to as the "Software". where more than one concurrent users can access the Software. printed materials.you must purchase a Server License.7 ODBC Driver for ASE THIS SOFTWARE. A Server License is valid for one single server installation.. GRANT OF LICENSE The enclosed Software is licensed. If you are a legally licensed user of the Software. You have the following rights and privileges. application servers. IF YOU DO NOT AGREE TO THE TERMS OF THIS LICENSE. and policies specified in this Agreement.

2. TRANSFER You may not transfer the Software to any individual or entity without express written permission from Devart. you may not share copies of the Software under "Desktop License" with other co-developers without obtaining proper license of these copies for each individual. 4. 3. You cannot distribute the Software integrated into your Applications. General Information 8 1. REDISTRIBUTION The license grants you a non-exclusive right to reproduce any new software programs(Applications) created using the Software. You may not distribute and sell any portion of the Software integrating it into your Applications. You may not reproduce or distribute any Software documentation without express written permission from Devart.3. In particular. 2. the Software license is non-transferable. You may not transfer. 2.1. 2.3. 2. trademark. Usage of the Software is subject to the following restrictions. you may not install the Software under "Server License" more than 1 (one) © 2016 Enter your company name . LIMITATIONS Only legally registered users are licensed to use the Software. You are allowed to use evaluation versions of the Software as specified in the Evaluation section. In particular.4. assign. You may not reverse engineer. No other rights or privileges are granted in this Agreement. You may not remove or alter any Devart's copyright. 2. decompile. and you may not transfer the Software installation package. 2.5. or modify the Software in whole or in part. or other proprietary rights notice contained in any portion of Devart files. or disassemble the Software. subject to all of the conditions of this Agreement. Any Devart's files remain Devart's exclusive property.

and all copies. you may install and use the Software for a period of up to 30 calendar days from the date of installation(the "Trial Period"). all accompanying written materials. including. subject to the additional restriction that it is used solely for evaluation of the Software and not in conjunction with the development or deployment of any application in production. You may transfer or distribute Trial versions of the Software as an original installation package only. EVALUATION Devart may provide evaluation ("Trial") versions of the Software.9 ODBC Driver for ASE server without obtaining proper license of these installations for each server. 6. all its copies and all accompanying written materials must be destroyed. the Software must be uninstalled. and may be subsequently renewed by Devart. Upon such termination you must destroy the Software.Devart makes no warranties. during the active subscription period. TERMINATION Devart may immediately terminate this Agreement without notice or judicial resolution in the event of any failure to comply with any provision of this Agreement. subject to receipt applicable fees. WARRANTY The Software and documentation are provided "AS IS" without warranty of any kind. SUBSCRIPTION AND SUPPORT The Software is sold on a subscription basis. but does not guarantee that your queries or problems will be fixed or solved. The initial subscription period is one year from the date of purchase of the license. 7. Upon expiration of the Trial Period. © 2016 Enter your company name . Devart shall use its reasonable endeavors to answer queries raised. but not limited to. You may not use Applications developed using Trial versions of the Software for any commercial purposes. The Software subscription entitles you to download improvements and enhancement from Devart's web site as they become available. 8.If the Software you have obtained is marked as a "Trial" version. 5. the implied warranties of merchantability and fitness for a particular purpose or use. The subscription is automatically activated upon purchase. Licensed users of the Software with an active subscription may request technical assistance with using the Software over email from the Software development. expressed or implied.

General Information 10 Devart reserves the right to cease offering and providing support for legacy IDE versions. Subscriptions The ODBC Driver for SAP Sybase Adaptive Server Enterprise Subscription program is an annual maintenance and support service for ODBC Driver for SAP Sybase Adaptive Server Enterprise users. Support Options There are a number of resources for finding help on installing and using ODBC Driver for SAP Sybase Adaptive Server Enterprise: You can find out more about ODBC Driver for SAP Sybase Adaptive Server Enterprise installation or licensing by consulting Installation and License articles of this manual respectively. written. Users with a valid ODBC Driver for SAP Sybase Adaptive Server Enterprise Subscription get the following benefits: Product support through the ODBC Driver for SAP Sybase Adaptive Server Enterprise © 2016 Enter your company name . All Rights Request Support ODBC Forum Provide Feedback Reserved. COPYRIGHT The Software is confidential and proprietary copyrighted work of Devart and is protected by international copyright laws and treaty provisions. oral. You can get community assistance and technical support on the Community Forum You can get advanced technical assistance by ODBC Driver for SAP Sybase Adaptive Server Enterprise developers through the ODBC Driver for SAP Sybase Adaptive Server Enterprise Priority Support program. You may not remove the copyright notice from any copy of the Software or any copy of the written materials. This Agreement contains the total agreement between the two parties and supersedes any other agreements. or implied.6 Getting Support This document lists several ways you can find help with using ODBC Driver for SAP Sybase Adaptive Server Enterprise describes the Priority Support program. 9. © 2015-2016 Devart. 2. expressed.accompanying the Software.

All Rights Request Support ODBC Forum Provide Feedback Reserved.com © 2015-2016 Devart. and the application using ODBC Driver for SAP Sybase Adaptive Server Enterprise. 3 Using ODBC Driver 1. You can find the version number in DLL version information.com describing the problem you are having. Secure Connections o SSL Connection © 2016 Enter your company name . 11 ODBC Driver for ASE Priority Support program < Access to new versions of ODBC Driver for SAP Sybase Adaptive Server Enterprise when they are released Access to all ODBC Driver for SAP Sybase Adaptive Server Enterprise updates and bug fixes Notifications about new product versions Priority Support ODBC Driver for SAP Sybase Adaptive Server Enterprise Priority Support is an advanced product support service for getting expedited individual assistance with ODBC Driver for SAP Sybase Adaptive Server Enterprise-related questions from the ODBC Driver for SAP Sybase Adaptive Server Enterprise developers themselves. Priority Support is available for users with an active ODBC Driver for SAP Sybase Adaptive Server Enterprise Subscription. scripts for creating and filling in database objects. please send an email to odbc@devart. If possible. If you have any questions regarding licensing or subscriptions. Versions of the ASE server and client you are using. Full ODBC Driver for SAP Sybase Adaptive Server Enterprise edition name and version number. Make sure to include the following information in your message: Your ODBC Driver for SAP Sybase Adaptive Server Enterprise Registration number. A detailed problem description. Connecting to ASE 3. Installation 2. Priority Support is carried out over email and has a two business day response policy. ODBC Administrator Log. please see the FAQ or contact sales@devart. Connection Options 4. To get help through the ODBC Driver for SAP Sybase Adaptive Server Enterprise Priority Support program.

Using ODBC Driver 12 o SSH Connection o HTTP Tunnelling 5. 1.1 Installation ODBC Driver for SAP Sybase Adaptive Server Enterprise currently supports such platforms as: Windows. Linux. See how to install Devart ODBC Driver for SAP Sybase Adaptive Server Enterprise on: Windows MacOS Linux © 2015-2016 Devart. 3. All Rights Request Support ODBC Forum Provide Feedback Reserved.1. In an explorer it must look like the following: 2. 3. MacOS. Supported Data Types 7. Follow the instructions in the wizard. both 32-bit and 64-bit. © 2016 Enter your company name . Run the installer executive file. Product Registration 6. make sure that another version of ODBC Driver for SAP Sybase Adaptive Server Enterprise is not installed on the PC. since more than one version cannot be installed simultaneously on one PC. Installation on Windows Important Note: Before installing the ODBC driver. All Rights Request Support ODBC Forum Provide Feedback Reserved. Supported ODBC API Functions © 2015-2016 Devart.1 Windows ODBC Driver for SAP Sybase Adaptive Server Enterprise currently supports such platforms as: Windows 32-bit and 64-bit.

4.13 ODBC Driver for ASE 3. but it is recommended to completely uninstall the previous driver version first. On the Select Components page you can select whether to install the 64-bit version of the driver or not. you will get a warning. © 2016 Enter your company name . and then install the new one. that allows you to select whether to install Help and Manual. Click Yes to overwrite the old files with the current installation. Clear the check box if you need no 64-bit installation. In case if you already have the specified installation folder on the PC or another Driver version is installed. There is also a check box on this page.

you should select the license type and activate the product. On the License Information page. © 2016 Enter your company name . Using ODBC Driver 14 5.

If you have no license key. 15 ODBC Driver for ASE Read the Product Registration article for more details about this step.1. All Rights Request Support ODBC Forum Provide Feedback Reserved. Click Install. 6. you can select Trial and use the driver for evaluation purposes. Click Finish.2 MacOS Prerequisites ODBC Driver for SAP Sybase Adaptive Server Enterprise works under control of an ODBC driver manager. ODBC Driver for SAP Sybase Adaptive Server Enterprise is compatible with 2 ODBC driver managers: iODBC © 2016 Enter your company name . ODBC driver manager is not distributed along with our driver and must be installed separately. © 2015-2016 Devart. 7. Click Next. 3. Then you need to configure the driver.

3.tar: tar -xf devartodbcase-osx. Navigate to the 'Documents' folder: cd . unpack and run installation with root privileges. you should download the archive containing installation files. 8. 2. it is 'test')./Users/test/Documents 5./install. Read the EULA carefully. See the detailed description of these steps below: 1.sh Password: 7.tar 6. but it will require manual modification of configuration files of these managers. ODBC Driver for SAP Sybase Adaptive Server Enterprise will be installed. Unpack devartodbcase-osx. Download the archive from Devart website. Using ODBC Driver 16 UnixODBC In case when using other ODBC driver managers.sh script with root user privileges and specify the password: sudo . Place the archive to the 'Documents' folder of the current user (in our sample. Run the 'Terminal' program: 4. Execute the install. Agree to the license agreement: 9. Select the installation folder for ODBC Driver for SAP Sybase Adaptive Server Enterprise © 2016 Enter your company name . Installation To install the driver.

1.Specify the path (or remain the default: /Library/ODBC) to odbc.Select the used ODBC driver manager (iODBC by default): 11.ini files. All Rights Request Support ODBC Forum Provide Feedback Reserved.3 Linux Prerequisites ODBC Driver for SAP Sybase Adaptive Server Enterprise works under control of an ODBC driver manager. Add the required parameters to the corresponding section of the odbc. To test connection using the DEVART_ASE_x86 sample. Run the iODBC Test Command utility: 3.ini file: User ID=<your ASE User Name> Port=<your ASE Listener Port> Database=<your ASE database name> 2. do the following: 1. © 2016 Enter your company name . ODBC driver manager is not distributed along with our driver and must be installed separately.ini and odbcinst. Driver is installed successfully. 3. 17 ODBC Driver for ASE (or accept the suggested path): 10. and test connection using the following command: dsn=DEVART_ASE_x86 See also: Installation on Windows Installation on Linux © 2015-2016 Devart.

Execute the install. 3. Run the 'Terminal' program. ODBC Driver for SAP Sybase Adaptive Server Enterprise will be installed. unpack and run installation with root privileges. Installation To install the driver. but it will require manual modification of configuration files of these managers. 4. it is 'test'). 2. Navigate to the 'Documents' folder: cd ~/Documents/ 5.tar: tar -xf devartodbcase-linux.tar 6. you should download the archive containing installation files. Using ODBC Driver 18 ODBC Driver for SAP Sybase Adaptive Server Enterprise is compatible with 2 ODBC driver managers: UnixODBC iODBC In case when using other ODBC driver managers. Place the archive to the 'Documents' folder of the current user (in our sample. Unpack devartodbcase-linux. See the detailed description of these steps below: 1. Download the archive from Devart website.sh script with root user privileges and specify the password: © 2016 Enter your company name .

Agree to the license agreement: © 2016 Enter your company name .sh Password: 7. 8./install.19 ODBC Driver for ASE sudo . Read the EULA carefully.

Using ODBC Driver 20 9. Select the installation folder for ODBC Driver for SAP Sybase Adaptive Server Enterprise (or accept the suggested path): © 2016 Enter your company name .

21 ODBC Driver for ASE 10.Select the used ODBC driver manager (UnixODBC by default): © 2016 Enter your company name .

specify the path to the License file in order to register the product.ini and odbcinst.You should create a License file on your computer and paste the license key in it. Using ODBC Driver 22 11.Specify the path (or remain the default: /etc) to odbc. Then.ini files. 12. © 2016 Enter your company name .

do the following: 1.23 ODBC Driver for ASE Driver is installed successfully. Add the required parameters to the corresponding section of the odbc. Run the UnixODBC Test Command utility: © 2016 Enter your company name . To test connection using the DEVART_MYSQL_x86 sample.ini file: User ID=<your ASE User Name> Port=<your ASE Listener Port> Database=<your ASE database name> 2.

2 Connecting to ASE 1. 3. After the driver is installed. it can be configured. Using ODBC Driver 24 3. and test connection using the following command: isql -v DEVART_ASE_X86 See also: Installation on Windows Installation on MacOS © 2015-2016 Devart. in the Control Panel open Administrative Tools and find the Data Sources (ODBC) tool: © 2016 Enter your company name . All Rights Request Support ODBC Forum Provide Feedback Reserved. For this.

Now you have to add the ODBC Driver for SAP Sybase Adaptive Server Enterprise to the list of System Data Sources or User Data Sources or File Data Sources using the ODBC Data Source Administrator dialog. 3. For this. Select ODBC Driver for SAP Sybase Adaptive Server Enterprise and click Finish. © 2016 Enter your company name .25 ODBC Driver for ASE 2. click the Add button .the Create New Data Source dialog will appear with a list of available drivers.

In the appeared connection dialog. 5. Using ODBC Driver 26 Then you will be suggested to configure the driver. 4. © 2016 Enter your company name . To activate the driver via ODBC Administrator. refer to the Product Registration article for more details. you can set the connection options.

3. Username Used to supply a user name for login. All Rights Request Support ODBC Forum Provide Feedback Reserved. Password Used to supply a password for login. Used to specify the port number for the Port connection. 5000 by default.3 Connection Options The following table describes the options that you can include in the connection string: Option Description Server Serves to supply the server name for login. See the full list of supported connection string options in the Connection Options article. © 2015-2016 Devart. Database Used to set the name of the database © 2016 Enter your company name . 27 ODBC Driver for ASE 6. Then you can click OK and finish configuration or switch to the Advanced settings tab to specify more detailed Connection String.

IPv4 and IPv6 are available. Holds the pathname to the certificate SSL CACert authority file.User ID=sa. SSL Connection Options Option Description Use SSL Enables or disables SSL for connection. Holds the host name or IP address of the SSH Host name SSH server to connect to.Port=5000. SSL Cert Holds the pathname to the certificate file. SSL Key Holds the pathname to the key file.Server=ASEserver. The IPVersion IPv4 + IPv6 value allows to check for available protocol versions and use the first available automatically.User ID=sa.Port=5000.Data Source=master. Example Connection String Login Prompt=False. SSH Connection Options Option Description Use SSH Enables or disables SSH tunneling. SSH Port Used to specify the port number for SSH © 2016 Enter your company name . Using ODBC Driver 28 Used to specify the time in seconds before ConnectionTimeout an attempt to make a connection is considered unsuccessful. Used to specify the version of the Internet Protocol. Example connection string using SSL Login Prompt=False.Server=ASEserver.Data Source=master. Holds the list of allowed ciphers to use for SSL CipherList SSL encryption.

User ID=sa.Port=5000. Http Url Holds the url of the tunneling PHP script. Used to specify the path to the file containing the SSH Private Key. connection may be established. SSH User Name Sets the SSH user name for authentication.Data Source=master. open Control Panel->Internet © 2016 Enter your company name . Sets the SSH user password for SSH Password authentication. while SSH Client Key the private key will be used by the client to sign data. specify the Proxy server address Proxy Host Name in this option. that will be used by server to authenticate the user. Used to specify the path to the file that SSH Server Key contains SSH Public Key. The server verifies the specified user name and Private Key - and if the Server Key corresponds to this user.29 ODBC Driver for ASE connection.Server=ASEserver. If the authentication by key is used. the user must have his pair of keys. If you are using Proxy for connection to your network. The public key should be transferred to the server. To learn your Proxy server address. Http Password Holds the password for HTTP authorization. Example connection string using SSH Login Prompt=False. Holds the user name for HTTP Http Username authorization. HTTP Connection Options Option Description Use Http Enables or disables HTTP tunneling.

It uses TCP/ IP on behalf of the higher-level protocols. The SSL protocol runs above TCP/IP and below higher-level database protocol. Example connection string using HTTP Tunnel Login Prompt=False. allows the client to authenticate itself to the server.1 SSL Connection SSL (Secure Sockets Layer) is the protocol for secure access to remote computers over insecure communication channels. 3.4. Holds the password for the proxy server Proxy Password account.Port © 2015-2016 Devart.168. All Rights Request Support ODBC Forum Provide Feedback Reserved.Port=5000. and in the process allows an SSL-enabled server to authenticate itself to an SSL-enabled client.User ID=sa.10. These capabilities address fundamental concerns about communication over the Internet and other TCP/IP networks: SSL server authentication allows a user to confirm a server's identity.Server=ASEserver. 3. Used to specify the port number for TCP/IP Proxy Port connection with proxy server. SSL-enabled client software can use standard techniques of public-key cryptography to check that a server's © 2016 Enter your company name .User ID=sa.0.4 Secure Connections This section describes the principles of establishing secure connections to MySQL using ODBC Driver for MySQL SSL Connection SSH Connection HTTP Tunnelling © 2015-2016 Devart. and allows both machines to establish an encrypted connection.Data Source=192. All Rights Request Support ODBC Forum Provide Feedback Reserved. Using ODBC Driver 30 Options->Connections->LAN settings.Server=ASEserver.Data Source=mater.U Example connection string using Proxy and HTTP Tunnel Login Prompt=False. Proxy Username Holds the proxy server account name.

the corresponding SSL connection options should be set: Using ODBC Data Source Administrator © 2016 Enter your company name . for example. thus providing a high degree of confidentiality. Note: Usage of SSL is more preferable for ASE connections than SSH because of less required settings and higher performance. SSL client authentication allows a server to confirm a user's identity. for example. Using the same techniques as those used for server authentication. Confidentiality is important for both parties to any private transaction. SSL is based on algorithms of asymmetric encryption and digital signature. all data sent over an encrypted SSL connection is protected with a mechanism for detecting tampering--that is. This confirmation might be important if the server. Consult ASE Reference Manual for information about Setting up SSL in ASE and Open Client and Configuring SSL . is a bank sending confidential financial information to a customer and wants to check the recipient's identity. How to connect to ASE using SSL To use SSL encryption for connection to ASE. for automatically determining whether the data has been altered in transit. In addition.31 ODBC Driver for ASE certificate and public ID are valid and have been issued by a certificate authority (CA) listed in the client's list of trusted CAs. is sending a credit card number over the network and wants to check the receiving server's identity. SSL-enabled server software can check that a client's certificate and public ID are valid and have been issued by a certificate authority (CA) listed in the server's list of trusted CAs. This confirmation might be important if the user. An encrypted SSL connection requires all information sent between a client and a server to be encrypted by the sending software and decrypted by the receiving software.

Holds the pathname to the certificate SSL CACert authority file. SSL Cert Holds the pathname to the certificate file.User ID=sa. Holds the list of allowed ciphers to use for SSL CipherList SSL encryption.Data Source=master. SSL Key Holds the pathname to the key file.Port=5000.Use SSL=true.SSL Connection Options Description Option Description Use SSL Enables or disables SSL for connection. © 2015-2016 Devart. All Rights Request Support ODBC Forum Provide Feedback Reserved. © 2016 Enter your company name . Using ODBC Driver 32 Using Connection String Login Prompt=False.

SSH Configuration using OpenSSH or other third-party SSH tunnel The following is the step-by-step sequence of actions for the easiest case of using OpenSSH for Windows. The general chart of computer ties when connecting through the SSH tunnel is presented below: This connection method provides secure connection between your application using ODBC Driver for SAP Sybase Adaptive Server Enterprise and SSH server that can go through insecure communication channels. The principle of working of the SSH connections is described below. SSH (Secure Shell) is the protocol for secure access to remote computers over insecure communication channels. the SSH server authenticates the client. 33 ODBC Driver for ASE 3. therefore they should go through secure communication channels.2 SSH Connection ODBC Driver for SAP Sybase Adaptive Server Enterprise allows connection to ASE server from a local computer using SSH tunneling. 1. but communication channel between SSH server and ASE server must be protected © 2016 Enter your company name . Download OpenSSH for Windows from http://sourceforge. the connection is established. and the server establishes it. In the confluent case. When the client tries to connect to this port. It does not have to be the same machine that is a ASE server. Install SSH server: o Choose a machine that will be used as SSH server.net/projects/sshwindows/ 2. The client sends an inquiry to establish necessary connection to SSH server. DB server and SSH server can be located on the same computer. The SSH server listens to the specified TCP/IP port. If the authentication passes. like Internet. Then the client should create connections to DB server objects.4. The detailed description of each command you can see in the documentation for OpenSSH. Connections between DB server and SSH server are insecure.

How to establish SSH connection to ASE To establish a SSH connection to ASE. Using ODBC Driver 34 o Using Windows Control Panel create a user and set a password for him. the corresponding connection options have to be set. like shown below: Using ODBC Data Source Administrator: © 2016 Enter your company name .) see documentation for OpenSSH.\etc\passwd o Use mkgroup to create a group permissions file mkgroup -l >> . etc.. For example. It is enough to install only Server components o Open OpenSSH/bin folder o Add SSHUser to the list of allowed users: mkpasswd -l -u SSHUser >> .. SSHUser with password SSHPass o Install Open SSH. since ODBC Driver for SAP Sybase Adaptive Server Enterprise itself implements SSH client functionality. About the methods of higher protection (key authentication.\etc\group o Run OpenSSH service net start opensshd Note: There is no need to install SSH client.

Port=5000.SSH SSH Connection Options Description: Option Description Use SSH Enables or disables SSH tunneling. If the authentication by key is used. Sets the SSH user password for SSH Password authentication. Holds the host name or IP address of the SSH Host name SSH server to connect to.User ID=sa.35 ODBC Driver for ASE Using Connection String: Login Prompt=False.Data Source=master. the user © 2016 Enter your company name . Used to specify the path to the file SSH Client Key containing the SSH Private Key. Used to specify the port number for SSH SSH Port connection. SSH User Name Sets the SSH user name for authentication.Use SSH=true.

run ODBC Driver installer. while the private key will be used by the client to sign data. 3. The public key should be transferred to the server. © 2016 Enter your company name .5.1 Driver Activation During Installation To activate your driver during installation. Used to specify the path to the file that SSH Server Key contains SSH Public Key. that will be used by server to authenticate the user. Follow the steps: 1. The server verifies the specified user name and Private Key - and if the Server Key corresponds to this user. 2. All Rights Request Support ODBC Forum Provide Feedback Reserved. 3. All Rights Request Support ODBC Forum Provide Feedback Reserved. select Licensed Key option.5 Product Registration Driver Activation During Installation Driver Activation After Installation Where to see the license information? © 2015-2016 Devart. On the License Information page. Copy the license key from the registration email carefully and paste it to the Licensed key edit box. connection may be established. © 2015-2016 Devart. Using ODBC Driver 36 must have his pair of keys.

click the Load License button and browse to the license file. If you have the license key file. © 2016 Enter your company name .37 ODBC Driver for ASE 3.

Using ODBC Driver 38 4.5. All Rights Request Support ODBC Forum Provide Feedback Reserved. 3. Click Next. © 2015-2016 Devart. perform the following steps: 1.2 Driver Activation After Installation To activate your installed driver using ODBC Administrator. 5. Run ODBC Administrator. Click Install. © 2016 Enter your company name .

© 2016 Enter your company name . click Finish. In the System DSN tab click the Add button.39 ODBC Driver for ASE 2. In the appeared dialog box select the installed driver. 3.

Copy the license key from the registration email carefully and paste it to the Input Licensed Key edit box. If you have the license key file. on the License tab. © 2016 Enter your company name . 6. click the Load Key button and browse to your license key file. Using ODBC Driver 40 4. click the Input License Key button. In the Driver Configuration dialog box. 5.

Open the System DSN tab and click the Add button 3. 3. © 2015-2016 Devart. Select the driver and click Finish © 2016 Enter your company name . 41 ODBC Driver for ASE 7. do the following: 1.5.3 Where to See the License Information? To see the license information of your installed driver. Click OK. In the Control Panel run ODBC Administrator 2. All Rights Request Support ODBC Forum Provide Feedback Reserved.

6 Supported Data Types ODBC Driver for SAP Sybase Adaptive Server Enterprise supports all the ASE data types. Data Type Mapping The following table describes how ODBC data types are mapped to ASE data types. select the License tab See also Product Registration © 2015-2016 Devart. The complete list of ASE data types is available in the ASE documentation. 3. In the appeared dialogue. ASE Data Types ODBC Data Types SQL_TYPE_TIMESTAMP Datetime SQL_TIMESTAMP © 2016 Enter your company name . Using ODBC Driver 42 4. All Rights Request Support ODBC Forum Provide Feedback Reserved.

SQLAllocHandle ISO 92 connection. An application can call SQLGetInfo function to obtain conformance information about ODBC Driver for SAP Sybase Adaptive Server Enterprise.microsoft. For the complete ODBC API reference. The following tables list ODBC Driver for SAP Sybase Adaptive Server Enterprise calls grouped by task: ODBC API Calls for Connecting to a Data Source Function Name Support Standard Purpose Obtains an environment. an application can call SQLGetFunctions. © 2016 Enter your company name . To obtain information about support for a specific function in the driver. please refer to the ODBC Programmer's Reference at http://msdn. All Rights Request Support ODBC Forum Provide Feedback Reserved. 43 ODBC Driver for ASE Smalldatetime SQL_TYPE_TIMESTAMP SQL_TIMESTAMP Date SQL_TYPE_DATE SQL_DATE Time SQL_SS_TIME2 Datetime2 SQL_TYPE_TIMESTAMP SQL_TIMESTAMP DatetimeOFFSET SQL_SS_TIMESTAMPOFFSET © 2015-2016 Devart. Connects to a SQLConnect ISO 92 specific driver by data source name.7 Supported ODBC API Functions This section summarizes ODBC routines. 3.aspx.com/en-us/library/ms714177. ODBC Driver for SAP Sybase Adaptive Server Enterprise supports all deprecated functions. statement. Important Note: For backward compatibility. categorized by functionality. or descriptor handle.

handled by the Driver Manager Returns the list of installed drivers and SQLDrivers ODBC their attributes. Obtains an environment handle SQLAllocEnv Deprecated allocated from driver. handles by Driver Manager Returns information SQLGetInfo ISO 92 about a specific driver and data © 2016 Enter your company name . and password. Connects to a specific driver by connection string or requests that the SQLDriverConnect ODBC Driver Manager and driver display connection dialog boxes for the user. Obtains a SQLAllocConnect Deprecated connection handle ODBC API Calls for Obtaining Information about a Driver and Data Source Function Name Support Standard Purpose Returns the list of available data SQLDataSources ISO 92 sources. Using ODBC Driver 44 user ID.

SQLSetConnectOpti Sets a connection Deprecated on option SQLGetConnectOpt Returns the value of Deprecated ion a connection option Sets an environment SQLSetEnvAttr ISO 92 attribute. Returns supported SQLGetFunctions ISO 92 driver functions. Returns the value of SQLGetStmtAttr ISO 92 a statement attribute. Sets a statement SQLSetStmtAttr ISO 92 attribute.45 ODBC Driver for ASE source. Returns the value of SQLGetEnvAttr ISO 92 an environment attribute. Returns information SQLGetTypeInfo ISO 92 about supported data types. Returns the value of SQLGetConnectAttr ISO 92 a connection attribute. Sets a statement SQLSetStmtOption Deprecated option © 2016 Enter your company name . ODBC API Calls for Setting and Retrieving Driver Attributes Function Name Support Standard Purpose Sets a connection SQLSetConnectAttr ISO 92 attribute.

ODBC API Calls for Submitting Requests Function Name Support Standard Purpose Executes a SQLExecute ISO 92 prepared statement. Assigns storage for SQLBindParameter ODBC a parameter in an SQL statement. SQLSetCursorNam Specifies a cursor ISO 92 e name. Using ODBC Driver 46 Returns the value of SQLGetStmtOption Deprecated a statement option ODBC API Calls for Preparing SQL Requests Function Name Support Standard Purpose Allocates a SQLAllocStmt Deprecated statement handle Prepares an SQL SQLPrepare ISO 92 statement for later execution. Executes a SQLExecDirect ISO 92 statement Returns the text of an SQLNativeSql ODBC SQL statement as © 2016 Enter your company name . Sets options that SQLSetScrollOption ODBC control cursor s behavior. Returns the cursor SQLGetCursorNam name associated ISO 92 e with a statement handle.

) Sends part or all of a data value for a SQLPutData ISO 92 parameter. Returns the number SQLNumResultCols ISO 92 of columns in the result set. or delete request. Returns the number SQLNumParams ISO 92 of parameters in a statement. © 2016 Enter your company name . (Useful for long data values. update.) ODBC API Calls for Retrieving Results and Information about Results Function Name Support Standard Purpose Returns the number of rows affected by SQLRowCount ISO 92 an insert. (Useful for long data values. Describes a column SQLDescribeCol ISO 92 in the result set. Used in conjunction with SQLPutData to supply parameter SQLParamData ISO 92 data at execution time.47 ODBC Driver for ASE translated by the driver. Returns the description for a SQLDescribeParam ODBC specific parameter in a statement.

Using ODBC Driver 48 Describes attributes SQLColAttribute ISO 92 of a column in the result set. and fetch by bookmark. including update. Returns scrollable SQLExtendedFetch Deprecated result rows. Performs bulk insertions and bulk bookmark SQLBulkOperations ODBC operations. Positions a cursor within a fetched block of data and enables an SQLSetPos ODBC application to refresh data in the rowset or to update or delete data in the result set. delete. Returns scrollable SQLFetchScroll ISO 92 result rows. Returns multiple SQLFetch ISO 92 result rows. ODBC API Calls for Retrieving Error or Diagnostic Information Function Name Support Standard Purpose © 2016 Enter your company name . Describes attributes SQLColAttributes Deprecated of a column in the result set.

Returns additional diagnostic information (multiple SQLGetDiagRec ISO 92 fields of the diagnostic data structure). ODBC API Calls for Obtaining Information about the Data Source's System Tables (Catalog Functions) Item Function Name Support Standard Purpose Returns a list of columns and SQLColumnPrivileg ODBC associated es privileges for one or more tables. © 2016 Enter your company name . Returns a list of column names that SQLForeignKeys ODBC make up foreign keys.49 ODBC Driver for ASE Returns additional SQLError Deprecated error or status information Returns additional diagnostic information (a single SQLGetDiagField ISO 92 field of the diagnostic data structure). Returns the list of SQLColumns X/Open column names in specified tables. if they exist for a specified table.

Returns statistics about a single table SQLStatistics ISO 92 and the list of indexes associated with the table. Using ODBC Driver 50 Returns the list of column names that SQLPrimaryKeys ODBC make up the primary key for a table. Returns the list of table names stored SQLTables X/Open in a specific data source. or the columns X/Open s that are automatically updated when any value in the row is updated by a transaction. Returns a list of tables and the SQLTablePrivileges ODBC privileges associated with each table. ODBC API Calls for Performing Transactions © 2016 Enter your company name . Returns information about the optimal set of columns that uniquely identifies a row in a specified SQLSpecialColumn table.

frees all resources associated with the statement handle. or descriptor handle. Releases an environment. ODBC API Calls for Terminating a Connection Function Name Support Standard Purpose Closes the SQLDisconnect ISO 92 connection. and. statement. Cancels an SQL SQLCancel ISO 92 statement. SQLFreeHandle ISO 92 connection.51 ODBC Driver for ASE Function Name Support Standard Purpose Commits or rolls SQLTransact Deprecated back a transaction Commits or rolls SQLEndTran ISO 92 back a transaction. discards pending results. © 2016 Enter your company name . SQLFreeStmt ISO 92 optionally. ODBC API Calls for Terminating a Statement Function Name Support Standard Purpose Ends statement processing. Closes a cursor that SQLCloseCursor ISO 92 has been opened on a statement handle.

All Rights Request Support ODBC Forum Provide Feedback Reserved. Using ODBC Driver 52 Releases SQLFreeConnect Deprecated connection handle. © 2016 Enter your company name . © 2015-2016 Devart. Releases an SQLFreeEnv Deprecated environment handle.