About this book

This book, the Open Client Client-Library Migration Guide, contains information on how to migrate Open Client™ DB-Library™ applications to Open Client Client-Library™.

This book has a dual audience:

• Managers or other decision makers who will decide whether to migrate a particular DB-Library application to Client-Library.

• Experienced DB-Library programmers who will perform the migration.

This book contains a number of code fragments taken from the set of migration sample programs that Sybase provides on the World Wide Web.

The example fragments in this book use the EXIT_ON_FAIL() example macro, which is as follows. Macros similar to this can simplify return code error checking. However, this macro is not appropriate for every situation.

/*
** Define a macro that exits if a function return code indicates
** failure. Accepts a CS_CONTEXT pointer, a Client-Library
** or CS-Library return code, and an error string. If the
** return code is not CS_SUCCEED, the context will be 
** cleaned up (if it is non-NULL), the error message is
** printed, and we exit to the operating system.
*/

#define EXIT_ON_FAIL(context, ret, str) \
  { if (ret != CS_SUCCEED) \
  { \
    fprintf(stderr, \
            "Fatal error: %s\n", str); \
    if (context != (CS_CONTEXT *) NULL) \
    { \
      (CS_VOID) ct_exit(context, CS_FORCE_EXIT); \
      (CS_VOID) cs_ctx_drop(context); \
    } \
    exit(ERROR_EXIT); \
  } }

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

Technical documentation at the Sybase Web site is updated frequently.

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

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.

Open Client and Open Server 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.

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 cannot resolve a problem using the manuals or online help, please have the designated person contact Sybase Technical Support or the Sybase subsidiary in your area.