Switch to standard view 
  Sybase logo
 
 
 



Release Bulletin Software Developer’s Kit 15.5 for Mac OS X

 

Document ID: DC00964-01-1550-01

Last revised: November 19, 2009

 


Accessing current release bulletin information

A more recent version of this release bulletin may be available on the Web. To check for critical product or document information added after the product release, use the Sybase® Product Manuals Web site.

Accessing release bulletins at the Sybase Product Manuals Web site

  1. Go to Product Manuals.

  2. Select a product and language and click Go.

  3. Select a product version from the Document Set list.

  4. Select the Release Bulletins link.

  5. From the list of individual documents, select the link to the release bulletin for your platform. You can either download the PDF version or browse the document online.

 


Product summary

Enclosed is Sybase Software Developer’s Kit (SDK) version 15.5, which is available on Apple Mac OS X Intel.

For the most current list of supported operating systems, see the Sybase platform certifications page. For a list of platforms, compilers, and third-party products on which SDK is built and tested, see New Features Open Server and SDK for Windows, Linux, UNIX, and Mac OS X.


Product components

For a list of SDK components and the platforms on which these components are supported, see Open Server and SDK New Features for Microsoft Windows, Linux, UNIX, and Mac OS X.


Utilities

bcp, isql, and defncopy are available on Mac OS X. There are two versions of these utilities—nonthreaded and native-threaded. The native-threaded version names have “_r” suffixes.


Security

Mac OS X supports CSI-SSL (OpenSSL).


POSIX threads and pthreads libraries

Open Client™ uses POSIX threads. The Apple Mac OS X Intel system libraries include APIs for creating and implementing POSIX threads.

Note:DB-Library™ does not support any type of thread interface.


IPv6 support

Sybase SDK version 15.5 on Mac OS X platforms support IPv6.

This is a sample interfaces file entry:

BARNARD_OS
   master tcp ether barnards.sybase.com 18200
   query tcp ether barnards.sybase.com 18200
   master tcp ether barnards.v6.sybase.com 18200
   query tcp ether barnards.v6.sybase.com 18200
   master tcp ether
     fd77:55d:59d9:165:203:baff:fe68:aa12 18200
   query tcp ether
     fd77:55d:59d9:165:203:baff:fe68:aa12 18200

Note:All master and query lines in the interfaces file must begin with a tab.


Sample files

You can find sample source code files in the SDK installation directory $SYBASE/$SYBASE_OCS/sample.

 


Special installation and configuration instructions

See the Software Developer’s Kit Installation Guide for Mac OS X for instructions about how to install the software.

For instructions about configuring the Open Client environment, see the Open Client Configuration Guide for Mac OS X. For configuring ODBC, see Adaptive Server ODBC Driver Users Guide.

For information about compiling and executing SDK applications, including the sample programs, see the Open Client Programmers Supplement for Mac OS X.


Installing EBFs

To ensure that your installation is the most current, Sybase strongly recommends that, after you install SDK version 15.5, you download and install the corresponding latest available EBF. You can download product updates from Sybase Downloads.

To verify that you are using the correct version of SDK, enter the following command to check the version string of the SDK library:

isql -v

A sample SDK version string might be Client-Library/15.5/P-EBF17930. In this version string, 17930 identifies the Client-Library file and the other SDK files.


Installing SDK 15.5 on top of SDK 15.0

SDK version 15.5 is a shelf replacement for version 15.0. When you install SDK 15.5 into an existing SDK 15.0 directory, version 15.5 files overwrite the 15.0 files. Sybase recommends that you back up your SDK 15.0 directory before you install SDK 15.5.


Modifying interfaces file entries

Use a text editor of your choice to modify directory service entries in the interfaces file. For information about setting the correct environment variables, see the Open Client Configuration Guide for Mac OS X.

 


Changed functionality in this version

Changed functionality for Sybase SDK 15.5 is described in the Open Server and SDK New Features for Microsoft Windows, Linux, UNIX, and Mac OS X.

 


Known problems

This section describes all of the known issues that exist in this version.


Adaptive Server Enterprise ODBC Driver issues

This section describes the known problems and workarounds, if any, for Adaptive Server® Enterprise ODBC Driver.


Limitations when used with Adaptive Server 12.0.x

The following are limitations of Adaptive Server ODBC Driver when used with Adaptive Server version 12.0.x:

Workaround: Upgrade to the current version of Adaptive Server.


Environment variables required to use SSL encryption and extended password encryption

[CR #547920 and CR #548785] If your ODBC Driver uses SSL encryption or extended password encryption to pass the password to Adaptive Server, you need to set the $SYBASE environment variable to the Sybase installation directory, and the $SYBCSI_PROVIDER_DIRECTORY environment variable to a directory with suitable cryptographic providers. Typically, $SYBCSI_PROVIDER_DIRECTORY is set to $SYBASE/DataAccess/ODBC/lib/csi, unless you have defined $SYBCSI_PROVIDER_DIRECTORY to point to the location of a different but compatible provider.


Behavior change when datetime parameter is out of range

When you use Adaptive Server ODBC Driver 15.0 or earlier, or connect to Adaptive Server version 15.0.x or earlier, and the application binds a datetime parameter to an invalid datetime range, such as 01-01-0001, the Adaptive Server ODBC Driver returns error 30122, Invalid datetime field. Year is out of range.

For an Adaptive Server ODBC Driver 15.5 that is connected to Adaptive Server 15.5, this behavior has changed. In the 15.5 versions, Adaptive Server ODBC Driver sends the date to Adaptive Server, and Adaptive Server returns an error. The error code returned is 247, Arithmetic overflow during implicit conversion of BIGDATETIME value 'Jan 1 0001 12:00AM' to a DATETIME field, or something similar.

 


Product compatibility and interoperability

This section contains information about products that are compatible with SDK 15.5. For a list of platforms, compilers, and third-party products SDK is built and tested on, see the New Features Open Server and SDK for Windows, Linux, UNIX, and Mac OS X.


Interoperability matrix

Table 1 shows the interoperability matrix of SDK, Open Server, Adaptive Server, and Replication Server® that are installed on the same machine. For specific platform information, refer to the respective product certification reports.

Although two or more products can be interoperable, remember that new features introduced in a newer version of a product may not be supported with older versions of the same or other products.

Table 1: Interoperability matrix

SDK

Open Server

Adaptive Server

Replication Server

15.5

15.5

15.0

12.5.1

15.5

15.0.x

12.5.x

15.5

15.2

15.1

15.0.1

12.6

Apple Mac OS X Intel

n/a

n/a

n/a

n/a

n/a

x

n/a

n/a

n/a

n/a

x

HP HP-UX PA-RISC 32-bit

x

x

x

n/a

n/a

x

n/a

n/a

x

x

x

HP HP-UX PA-RISC 64-bit

x

x

x

x

x

x

n/a

n/a

n/a

n/a

n/a

HP HP-UX Itanium 32-bit

x

x

x

n/a

n/a

n/a

n/a

n/a

n/a

x

x

HP HP-UX Itanium 64-bit

x

x

x

x

x

x

x

x

x

n/a

n/a

IBM AIX POWER 32-bit

x

x

x

n/a

n/a

x

n/a

x

x

x

x

IBM AIX POWER 64-bit

x

x

x

x

x

x

x

n/a

n/a

n/a

n/a

Linux x86 32-bit

x

x

x

x

x

x

x

x

x

x

x

Linux x86-64 64-bit

x

x

x

x

x

x

x

n/a

n/a

n/a

n/a

Linux POWER 32-bit

x

x

x

n/a

n/a

n/a

n/a

n/a

n/a

n/a

n/a

Linux POWER 64-bit

x

x

x

x

x

x

x

x

x

n/a

n/a

Sun Solaris SPARC 32-bit

x

x

x

x

x

x

n/a

x

x

x

x

Sun Solaris SPARC 64-bit

x

x

x

x

x

x

x

n/a

n/a

n/a

n/a

Sun Solaris x86-64 32-bit

x

x

x

n/a

n/a

x

n/a

x

x

n/a

x

Sun Solaris x86-64 64-bit

x

x

x

x

x

x

x

n/a

n/a

n/a

n/a

Microsoft Windows x86 32-bit

x

x

x

x

x

x

x

x

x

x

x

Microsoft Windows x86-64 64-bit

x

x

x

x

x

n/a

x

n/a

n/a

n/a

n/a

LEGEND: x = interoperable; n/a = product not available or does not work with SDK on that platform.


Guidelines for installing SDK with other Sybase products

In general, Sybase recommends that you place the new installation of SDK in separate directories from other Sybase products, such as Replication Server and Adaptive Server, unless Sybase Tech Support has specifically recommended installation in the same directory to address an issue.


DB-Library compatibility with Client-Library

DB-Library compatibility issues include:

For help on converting a DB-Library application to a Client-Library application, see the Open Client Client-Library Migration Guide.

 


Programming issues

This section describes programming issues relevant to Sybase Software Developer’s Kit.


General issues

This section describes programming issues for all Open Client products.


Upgrading to a new version

For statically and dynamically linked Open Client applications (dblib and ctlib), Sybase recommends the following:

Note:Existing Mac OS X on PowerPC applications from SDK 12.5.1 and earlier should be recompiled in order to run these applications natively on Mac OS X Intel.

Ensure that the runtime libraries are for the same major release as the version used to build the application.


Client-Library issues

This section describes programming issues of Client-Library.


ct_poll

Do not call ct_poll from within any Client-Library callback function or from within any other function that can execute at the system-interrupt level. Calling ct_poll at the system-interrupt level corrupts Open Client and Open Server internal resources and causes recursion in the application.


Asynchronous operations

To properly exit Client-Library, wait until all asynchronous operations are complete, then call ct_exit. If an asynchronous operation is in progress when ct_exit is called, the routine returns CS_FAIL and does not exit Client-Library properly, even when CS_FORCE_EXIT is used.

Client-Library fully supports asynchronous operations on UNIX platforms. See “Asynchronous Programming” in the Open Client Client-Library/C Reference Manual.

 


Technical support

Each Sybase installation that has purchased a support contract has one or more designated people who are authorized to contact Sybase Technical Support. If you have any questions about this installation or if you need assistance during the installation process, ask the designated person to contact Sybase Technical Support or the Sybase subsidiary in your area.

 


Other sources of information

Use the Sybase Getting Started CD, the SyBooks™ CD, and the Sybase Product Manuals Web site to learn more about your product:


Sybase certifications on the Web

Technical documentation at the Sybase Web site is updated frequently.

Finding the latest information on product certifications

  1. Point your Web browser to Technical Documents.

  2. Click Partner Certification Report.

  3. In the Partner Certification Report filter select a product, platform, and timeframe and then click Go.

  4. Click a Partner Certification Report title to display the report.

Finding the latest information on component certifications

  1. Point your Web browser to Availability and Certification Reports.

  2. Either select the product family and product under Search by Base Product; or select the platform and product under Search by Platform.

  3. Select Search to display the availability and certification report for the selection.

Creating a personalized view of the Sybase Web site (including support pages)

Set up a MySybase profile. MySybase is a free service that allows you to create a personalized view of Sybase Web pages.

  1. Point your Web browser to Technical Documents.

  2. Click MySybase and create a MySybase profile.


Sybase EBFs and software maintenance

Finding the latest information on EBFs and software maintenance

  1. Point your Web browser to the Sybase Support Page.

  2. Select EBFs/Maintenance. If prompted, enter your MySybase user name and password.

  3. Select a product.

  4. Specify a time frame and click Go. A list of EBF/Maintenance releases is displayed.

    Padlock icons indicate that you do not have download authorization for certain EBF/Maintenance releases because you are not registered as a Technical Support Contact. If you have not registered, but have valid information provided by your Sybase representative or through your support contract, click Edit Roles to add the “Technical Support Contact” role to your MySybase profile.

  5. Click the Info icon to display the EBF/Maintenance report, or click the product description to download the software.

 


Accessibility features

This document is available in an HTML version that is specialized for accessibility. You can navigate the HTML with an adaptive technology such as a screen reader, or view it with a screen enlarger.

SDK documentation has been tested for compliance with U.S. government Section 508 Accessibility requirements. Documents that comply with Section 508 generally also meet non-U.S. accessibility guidelines, such as the World Wide Web Consortium (W3C) guidelines for Web sites.

Note:You might need to configure your accessibility tool for optimal use. Some screen readers pronounce text based on its case; for example, they pronounce ALL UPPERCASE TEXT as initials, and MixedCase Text as words. You might find it helpful to configure your tool to announce syntax conventions. Consult the documentation for your tool.

For information about how Sybase supports accessibility, see Sybase Accessibility. The Sybase Accessibility site includes links to information on Section 508 and W3C standards.