SAP Adaptive Server Enterprise 16.0
SAP Adaptive Server Enterprise 16.0 (Japanese)
SAP Adaptive Server Enterprise 16.0 (Simplified Chinese)
Adaptive Server Enterprise 15.7 SP121
Adaptive Server Enterprise 15.7 SP110
Adaptive Server Enterprise 15.7 SP100
Adaptive Server Enterprise 15.7 SP60
Adaptive Server Enterprise 15.7 SP50
Adaptive Server Enterprise 15.7 ESD #4
Adaptive Server Enterprise 15.7 ESD #3
Adaptive Server Enterprise 15.7 ESD #2
Adaptive Server Enterprise 15.7 ESD #2 (Japanese)
Adaptive Server Enterprise 15.7 ESD #2 (Simplified Chinese)
Adaptive Server Enterprise 15.7
Adaptive Server Enterprise 15.7 (Japanese)
Adaptive Server Enterprise 15.7 (Simplified Chinese)
Adaptive Server Enterprise 15.5
Adaptive Server Enterprise 15.5 - Simplified Chinese
Adaptive Server Enterprise 15.5 (Japanese)
Adaptive Server Enterprise 12.5.4
Adaptive Server Enterprise 12.5.4 (Simplified Chinese)
Adaptive Server Enterprise 12.5.4 (French)
Adaptive Server Enterprise 12.5.4 (Japanese)
Adaptive Server Enterprise 12.5.3
Adaptive Server Enterprise 12.5.2
Adaptive Server Enterprise 12.5.1
AppBuilder 1.0
Appeon 6.5.1 for PowerBuilder
Appeon 6.5 for PowerBuilder
Appeon 6.2 for PowerBuilder
Appeon 6.1 for PowerBuilder
Appeon 6.0 for PowerBuilder
Appeon 6.0 for PowerBuilder (Japanese)
Avaki EII 7.1
Avaki EII 7.0
Avaki EII 6.2
DataWindow .NET 2.5
DataWindow .NET 2.0.1
DataWindow .NET 2.0
EAServer 6.3.1
EAServer 6.3
EAServer 6.2
EAServer 6.1
EAServer 6.0.2
EAServer 6.0
EAServer 5.5
EAServer 5.3
EAServer 5.2.1
EAServer 5.2
EAServer 5.0.1
EDI Products 5.2.2
Enterprise Connect Data Access 15.7
Enterprise Connect Data Access 15.0.1
Enterprise Connect Data Access 15.0
Enterprise Connect Data Access 12.6.1
Enterprise Connect Data Access 12.6
Financial Fusion GlobalFIX 6.0
InfoMaker 12.5.2
InfoMaker 12.5
SAP jConnect for JDBC 16.0
jConnect for JDBC 7.07 SP110
jConnect for JDBC 7.07 SP100
jConnect for JDBC 7.07
jConnect for JDBC 7.0
jConnect for JDBC 6.05
jConnect for JDBC 5.5
M-Business Anywhere 7.0
M-Business Anywhere 6.7
Mainframe Connect 15.0
Mainframe Connect 12.6.1
Mainframe Connect 12.6
SAP Open Server 16.0
SAP Open Server 15.7 SP127
Open Server 15.7 SP121
Open Server 15.7 SP110
Open Server 15.7 SP100
Open Server 15.7
Open Server 15.5
Open Server 15.0, Open Client 15.0, and SDK 15.0
Release Bulletin Open Server 15.0 for IBM AIX
Accessing current release bulletin information
Product summary
Product components
POSIX threads and pthreads libraries
IPv6 support
Sample files
Special installation instructions
Installing EBFs
Installation and configuration instructions
Modifying interfaces file entries with dscp or dsedit
Changed functionality in this version
Known problems
Availability with 64-bit libraries
Open Server hangs when file descriptor limit exceeds
Open Server shutdown dumps when running sample programs
Incorrect ASE default packet size with SSL functionality causes Open Client/Open Server applications to hang
Error in installer string
Language installation using ASE langinstall fails in pre-15.0 ASE location
InstallShield issues
Server not responding causes InstallShield to hang
Installation fails with a “JVM not found” error
InstallShield overwrites existing Sybase files
Error messages received during creation of response file
Product compatibilities and interoperability
Open Client and Open Server compatibility
Interoperability matrix
Guidelines for installing Open Server with other Sybase products
SDK and Open Server compatibility
Programming issues
General issues
Upgrading to a new release
Open Server issues
Timeslice property and multithreaded library versions
Technical support
Other sources of information
Sybase certifications on the Web
Sybase EBFs and software maintenance
Accessibility features
Release Bulletin Open Server 15.0 for HP-UX
Accessing current release bulletin information
Product summary
Product components
Patches
POSIX threads and pthreads libraries
IPv6 support
Sample files
Special installation instructions
Installing EBFs
Installation and configuration instructions
Modifying interfaces file entries with dscp or dsedit
Changed functionality in this version
Known problems
Availability with 64-bit libraries
Open Server hangs when file descriptor limit exceeds
Incorrect ASE default packet size with SSL functionality causes Open Client/Open Server applications to hang
Error in installer string
Language installation using ASE langinstall fails in pre-15.0 ASE location
InstallShield issues
Server not responding causes InstallShield to hang
Installation fails with a “JVM not found” error
InstallShield overwrites existing Sybase files
Installation using response file fails
Error messages received during creation of response file
Product compatibilities and interoperability
Open Client and Open Server compatibility
Interoperability matrix
Guidelines for installing Open Server with other Sybase products
SDK and Open Server compatibility
Programming issues
General issues
Upgrading to a new release
Open Server issues
Timeslice property and multithreaded library versions
Technical support
Other sources of information
Sybase certifications on the Web
Sybase EBFs and software maintenance
Accessibility features
Release Bulletin Open Server 15.0 for Linux
Accessing current release bulletin information
Product summary
Product components
Patches
POSIX threads and pthreads libraries
IPv6 support
Sample files
Special installation instructions
Installing EBFs
Installation and configuration instructions
Pre-installation instructions for Linux on POWER (32-bit and 64-bit)
Modifying interfaces file entries with dscp or dsedit
Changed functionality in this version
Known problems
Installer fails to launch when SELinux is enabled
Language installation using ASE langinstall fails in pre-15.0 ASE location
Error in installer string
Open Server hangs when file descriptor limit exceeds
InstallShield issues
ClearCase on Linux causes InstallShield to hang
InstallShield overwrites existing Sybase files
Installation fails with a “JVM not found” error
Server not responding causes InstallShield to hang
Error messages received during creation of response file
Product compatibilities and interoperability
Open Client and Open Server compatibility
Interoperability matrix
Guidelines for installing Open Server with other Sybase products
SDK and Open Server compatibility
Programming issues
General issues
Upgrading to a new release
Open Server issues
Timeslice property and multithreaded library versions
Technical support
Other sources of information
Sybase certifications on the Web
Sybase EBFs and software maintenance
Accessibility features
Release Bulletin Open Server 15.0 for Sun Solaris
Accessing current release bulletin information
Product summary
Product components
Patches
POSIX threads and pthreads libraries
IPv6 support
Sample files
Special installation instructions
Installing EBFs
Installation and configuration instructions
Modifying interfaces file entries with dscp or dsedit
Changed functionality in this version
Known problems
Open Server call leaks memory on Sun Solaris platforms
Availability with 64-bit libraries
Open Server hangs when file descriptor limit exceeds
Incorrect ASE default packet size with SSL functionality causes Open Client/Open Server applications to hang
Error in installer string
Language installation using ASE langinstall fails in pre-15.0 ASE location
InstallShield issues
Server not responding causes InstallShield to hang
Installation fails with a “JVM not found” error
InstallShield overwrites existing Sybase files
Error messages received during creation of response file
Product compatibilities and interoperability
Open Client and Open Server compatibility
Interoperability matrix
Guidelines for installing Open Server with other Sybase products
SDK and Open Server compatibility
Programming issues
General issues
Upgrading to a new release
Link to usr/lib/lwp
Programming with thread-safe libraries
Open Server issues
Timeslice property and multithreaded library versions
Technical support
Other sources of information
Sybase certifications on the Web
Sybase EBFs and software maintenance
Accessibility features
Release Bulletin Open Server 15.0 for Microsoft Windows
Accessing current release bulletin information
Product summary
Product components
IPv6 support
Sample files
Special installation instructions
Installing EBFs
Installation and configuration instructions
Running different versions of Open Server on Windows
Changed functionality in this version
Known problems
Incorrect ASE default packet size with SSL functionality causes Open Client/Open Server applications to hang
Error in installer string
Language installation using ASE langinstall fails in pre-15.0 ASE location
InstallShield issues
InstallShield overwrites existing Sybase files
Error messages received during creation of response file
Product compatibilities and interoperability
Open Client and Open Server compatibility
Interoperability matrix
Guidelines for installing Open Server with other Sybase products
SDK and Open Server compatibility
Programming issues
General issues
Upgrading to a new release
System path restriction
Open Server issues
Open Server routines not supported
Technical support
Other sources of information
Sybase certifications on the Web
Sybase EBFs and software maintenance
Accessibility features
Installation Guide SDK 15.0 for Mac OS X
About this book
Before You Begin
Supported platforms
SDK components
SDK components
SDK libraries and utilities
System requirements for the SDK
Pre-installation instructions for the SDK
Installing the SDK
SDK installation methods
Installation on Xserve
Uninstalling the SDK
Post-Installation Tasks
Setting environment variables
Configuring the components
Modifying interfaces file entries
Installation Guide SDK and Open Server 15.0 for UNIX
About this book
Before You Begin
Supported platforms
SDK and Open Server components
SDK components
SDK libraries and utilities
Open Server components
Open Server libraries and utilities
System requirements for the SDK and Open Server
Hardware and software requirements
Disk space requirements
Disk space required for installation
jConnect requirements
Pre-installation instructions for the SDK and Open Server
Pre-installation instructions for Linux on POWER (32-bit and 64-bit)
Linux PowerPC runtime libraries to run Open Server, SDK, and Adaptive Server executables
Installing the SDK and Open Server
Using InstallShield for installation
Installing on a remote machine
Installing using a different font
Using the -font command line option
Using the font.ini file
SDK or Open Server installation methods
Installing 15.0 on the same machine as a pre-15.0 Adaptive Server
Mount the CD
Installing in GUI mode
Installing in console mode
Installing using a response file
Creating a response file
Installing interactively using a response file
Installing in silent mode
Uninstalling the SDK or Open Server
Special uninstall considerations
Uninstall procedure
Missing uninstall components
Command-line options
Post-Installation Tasks
Setting environment variables
Configuring the components
Modifying interfaces file entries
Installation Guide SDK and Open Server 15.0 for Windows
About this book
Before You Begin
Supported Microsoft Windows platforms
SDK and Open Server components
SDK components
SDK libraries and utilities
Open Server components
Open Server libraries and utilities
System requirements for SDK and Open Server
Hardware and software requirements
Installing data access components from Microsoft
Disk space requirements
Disk space required for the installation
jConnect requirements
Pre-installation instructions
Pre-installation tasks for SDK and Open Server
Installing SDK and Open Server
Using InstallShield for installation
Installing using a different font
Using the -font command line option
Using the font.ini file
Installing SDK or Open Server
Installing 15.0 on the same machine as a pre-15.0 ASE
Starting ASE servers
Installing in GUI mode
Installing in console mode
Installing using a response file
Creating a response file
Interactive installation using a response file
Installing in silent mode
Uninstalling SDK or Open Server
Special uninstall considerations
Uninstall procedure
Command-line options
Post-Installation Tasks
Setting environment variables
Configuring the components
Configuration Guide Open Client 15.0 for Mac OS X
About this book
Configuration Overview
About Open Client
Overview of configuration
The initialization process
The connection process
Configuration tasks
Basic Configuration for Open Client
Overview of configuration for Open Client
Configuration tasks for Open Client
Client-Library compatibility
Configuring Open Client for Sybase Failover
Add hafailover line to interfaces file
Client-Library application changes
Using isql with Sybase HA Failover
Environment Variables
Environment variables used for connection
Environment variables used for localization
Environment variables used for configuration
Setting environment variables
Configuration Files
About configuration files
The libtcl.cfg file
The interfaces file
interfaces entries
Standard format
Editing the interfaces file
Standby server addressing
The ocs.cfg file
Localization
Overview of the localization process
Environment variables used during localization
Localization files
The locales directory
The locales.dat file
Localized message files
The charsets directory
Collating sequence files
Unicode conversion files
The config directory
The objectid.dat file
Secure Sockets Layer in Open Client and Open Server
SSL description
SSL handshake
SSL security levels in Open Client
The SSL filter
Validating a server by its certificate
Common name validation in a SDC environment
The trusted roots file
Obtaining a server certificate
Using third-party tools to request certificates
Customized Open SSL support
Configuration Guide Open Client and Open Server 15.0 for UNIX
About this book
Configuration Overview
About Open Client and Open Server
Overview of configuration
The initialization process
The connection process
Configuration tasks
Basic Configuration for Open Client
Overview of configuration for Open Client
Configuration tasks for Open Client
Client-Library compatibility
Basic Configuration for Open Server
About Open Server applications
Overview of configuration for Open Server
Open Server compatibility
Configuration tasks
Configuring Open Client for Sybase Failover
Add hafailover line to interfaces file
Client-Library application changes
Using isql with Sybase HA Failover
Using a Directory Service
Overview of directory services
LDAP directory services
LDAP directory services versus the Sybase interfaces file
Server objects and attributes
How applications use a directory service
How applications use LDAP directory services
Authentication
Enabling LDAP directory services
Multiple directory services with LDAP
Importing Microsoft Active Directory schema
Creating a container for Sybase server entries
Connecting to LDAP using SSL/TLS
Using Security Services
Overview of network-based security
Security mechanisms
Security drivers
Security services
How applications use security services
Client-Library and security services
Server-Library and security services
Configuration tasks
Configure Kerberos
Configure libtcl.cfg
Using dscp
About dscp
Starting dscp
Viewing your configuration
Getting help
Using dscp sessions
Adding and modifying server entries
Listing server entries
Viewing a server entry
Adding a server entry
Modifying a server entry
Deleting server entries
Copying server entries
Copying entries within a session
Copying entries between sessions
Copying all entries to a different session
Exiting dscp
Using dsedit
About dsedit
Starting dsedit
Opening a session
Interfaces file sessions
Adding a server to the directory services
Adding, viewing, and editing server entries
Adding or editing network transport addresses
TCP/IP addresses
Troubleshooting dsedit or dsedit problems
dsedit does not start
Cannot add, modify, or delete server entries
Environment Variables
Environment variables used for connection
Environment variables used for localization
Environment variables used for configuration
Setting environment variables
Configuration Files
About configuration files
The libtcl.cfg and libtcl64.cfg files
Dynamic linking of drivers
How libtcl.cfg is used
How libtcl.cfg is structured
DIRECTORY section
For LDAP entries in the DIRECTORY section
SECURITY section
Adding a directory driver
Adding a security driver
The interfaces file
interfaces entries
Standard format
Editing the interfaces file
Standby server addressing
The ocs.cfg file
Localization
Overview of the localization process
Environment variables used during localization
Localization files
The locales directory
The locales.dat file
Localized message files
The charsets directory
Collating sequence files
Unicode conversion files
The config directory
The objectid.dat file
Kerberos Security Services
Supported security services
Configuring CyberSafe Kerberos
Open Server applications and CyberSafe Kerberos
Client-Library applications and CyberSafe Kerberos
Configuring MIT Kerberos
Open Server applications and MIT Kerberos
Client-Library applications and MIT Kerberos
Credential delegation for MIT Kerberos
Configuring Sun Solaris Kerberos
Configuring Kerberos environments and mixed Kerberos environments
Secure Sockets Layer in Open Client and Open Server
SSL description
SSL handshake
SSL security levels in Open Client and Open Server
The SSL filter
Validating a server by its certificate
Common name validation in an SDC environment
The trusted roots file
Obtaining a server certificate
Using third-party tools to request certificates
Using Sybase tools to request and authorize certificates
Description of Sybase tools
The certauth utility
The certreq utility
The certpk12 utility
Customized Open SSL support
Configuration Guide Open Client and Open Server 15.0 for Windows
About this book
Configuration Overview
About Open Client and Open Server
Overview of configuration
The initialization process
The connection process
Configuration tasks
Basic Configuration for Open Client
Overview of basic configuration
Configuration tasks
Set environment variables
Configure the drivers
Configure sql.ini
Basic Configuration for Open Server
About Open Server applications
Overview of basic configuration
Configuration tasks
Configure sql.ini or Registry
Set environment variables
Configure the drivers
Configuring Open Client for Sybase Failover
Adding a hafailover line to the sql.ini file
Client-Library application changes
Using isql with Sybase Failover
Using a Directory Service
Overview of directory services
LDAP
LDAP directory services versus the Sybase sql.ini file
Server objects and attributes
Directory drivers
How applications use a directory service
How applications use LDAP directory services
Authentication
Enabling LDAP directory services
Multiple directory services with LDAP
Importing Microsoft Active Directory schema
Creating a container for Sybase server entries
Connecting to LDAP using SSL/TLS
Configuration tasks for DCE directory service
Using Security Services
Overview of network-based security
Security mechanisms
Security drivers
Security services
LAN Manager security services
Kerberos security services
How applications use security services
Client-Library and security services
Server-Library and security services
Configuration tasks
Using ocscfg
About ocscfg
Starting ocscfg
Setting environment variables
Setting the SYBASE environment variables
Setting other environment variables
Clearing environment variables
Configuring a directory driver
Adding a directory driver entry
DIT base syntax
Modifying an existing directory driver entry
Deleting a directory driver entry
Activating a directory driver
Configuring a security driver
Adding a security driver entry
Modifying an existing security driver entry
Deleting a security driver entry
Setting the default security driver
Using dsedit
Using dsedit
Opening a session
Opening additional sessions
Activating sessions
Adding a server to the directory services
Making and modifying server entries
Adding a server entry
Modifying a server entry
Renaming a server entry
Deleting entries
Using the ping command
Copying server entries
Copying entries within a session
Copying entries between sessions
Exiting dsedit
Troubleshooting with dsedit
How dsedit works
Troubleshooting connection failures
If dsedit fails
If dsedit succeeds but other applications fail
Information you need for Sybase Technical Support
Commonly asked questions
Environment Variables
Environment variables used for connection
Environment variables used for localization
Environment variables used for configuration
Configuration Files
About configuration files
The libtcl.cfg and libtcl64.cfg files
Layout of libtcl.cfg
Directory drivers
For LDAP entries in the DIRECTORY section
Security drivers
libtcl.cfg example
The sql.ini file
sql.ini entries
sql.ini examples
Multiple connection service entries
Servers listening over multiple networks
Clients connecting over multiple networks
The ocs.cfg file
Localization
Overview of the localization process
Environment variables used during localization
Localization files
The locales directory
The locales.dat file
How locales.dat is used
locales.dat sections and entries
locales.dat example
Editing locales.dat
Localized message files
The charsets directory
Collating sequence files
Unicode conversion files
The ini directory
The objectid.dat file
Location of objectid.dat
objectid.dat sections and entries
objectid.dat example
Secure Sockets Layer in Open Client and Open Server
SSL handshake
SSL security levels and security mechanisms
Validating a server by its certificate
Common name validation in an SDC environment
The trusted roots file
Obtaining a certificate
Using third-party tools to obtain a certificate
Using Sybase tools to request and authorize certificates
certauth
certreq
certpk12
Customized Open SSL support
Programmers Supplement Open Client 15.0 for Mac OS X
About this book
Open Client Client-Library/C
General instructions
Building a Client-Library executable
Native thread support
Compile and link lines
Compile-and-link lines for non-threaded applications
Compile-and-link lines for multithreaded applications
Bulk copy routines
Performance considerations
Header files
Using Client-Library sample programs
Makefile and sample programs
Purpose of the sample programs
The sybopts.sh script and building applications
Location
Header file
EX_USERNAME
EX_PASSWORD
Utility routines for the sample programs
Sample program summaries
arraybind.c sample program
blktxt.c sample program
compute.c sample program
csr_disp.c sample program
csr_disp_scrollcurs.c sample program
csr_disp_scrollcurs2.c sample program
csr_disp_implicit.c sample program
ex_alib.c and ex_amain.c sample programs
exconfig.c sample program
firstapp.c sample program
getsend.c sample program
i18n.c sample program
multthrd.c and thrdfunc.c sample programs
rpc.c sample program
secct.c sample program
uni_blktxt.c sample program
uni_compute.c sample program
uni_csr_disp.c sample program
uni_firstapp.c sample program
uni_rpc.c sample program
usedir.c sample program
wide_compute.c sample program
wide_curupd.c sample program
wide_dynamic.c sample program
wide_rpc.c sample program
Open Client DB-Library/C
General instructions
Building a DB-Library executable
Libraries
Compile-and-link lines
Performance considerations
Header files
Using DB-Library sample programs
Purpose of the sample programs
Location
Header file
Sample program summaries
Example 1: Send queries, bind, and print results
Example 2: Insert data into a new table
Example 3: Bind aggregate and compute results
Example 4: Row buffering
Example 5: Data conversion
Example 6: Browse mode updates
Example 7: Browse mode and ad hoc queries
Example 8: Making a remote procedure call (RPC)
Example 9: Text and image routines
Example 10: Inserting an image
Example 11: Retrieving an image
Example 12: International language routines
Example 13: Bulk copy
Example 14: Two-phase commit
Utility Commands Reference
bcp
defncopy
isql
Environment Variables
Programmers Supplement Open Client and Open Server 15.0 for UNIX
About this book
Open Client Client-Library/C
General instructions
Building a Client-Library executable
Native thread support
Kerberos support
Compile and link lines
Compile-and-link lines for non-threaded applications
Compile-and-link lines for multithreaded applications
Compile-and-link lines for Kerberos supported applications
Bulk copy routines
Performance considerations
Header files
Using Client-Library sample programs
Makefile and sample programs
Purpose of the sample programs
The sybopts.sh script and building applications
Location
Header file
EX_USERNAME
EX_PASSWORD
Utility routines for the sample programs
Sample program summaries
arraybind.c sample program
blktxt.c sample program
compute.c sample program
csr_disp.c sample program
csr_disp_scrollcurs.c sample program
csr_disp_scrollcurs2.c sample program
csr_disp_implicit.c sample program
ex_alib.c and ex_amain.c sample programs
exconfig.c sample program
firstapp.c sample program
getsend.c sample program
i18n.c sample program
multthrd.c and thrdfunc.c sample programs
rpc.c sample program
secct.c sample program
uni_blktxt.c sample program
uni_compute.c sample program
uni_csr_disp.c sample program
uni_firstapp.c sample program
uni_rpc.c sample program
usedir.c sample program
wide_compute.c sample program
wide_curupd.c sample program
wide_dynamic.c sample program
wide_rpc.c sample program
Open Client DB-Library/C
General instructions
Building a DB-Library executable
Libraries
Compile-and-link lines
Performance considerations
Header files
Using DB-Library sample programs
Purpose of the sample programs
Location
Header file
Sample program summaries
Example 1: Send queries, bind, and print results
Example 2: Insert data into a new table
Example 3: Bind aggregate and compute results
Example 4: Row buffering
Example 5: Data conversion
Example 6: Browse mode updates
Example 7: Browse mode and ad hoc queries
Example 8: Making a remote procedure call (RPC)
Example 9: Text and image routines
Example 10: Inserting an image
Example 11: Retrieving an image
Example 12: International language routines
Example 13: Bulk copy
Example 14: Two-phase commit
Open Server Server-Library/C
General instructions
Building a Server-Library executable
Libraries
Compile-and-link line commands
Kerberos support
Bulk copy routines
Performance considerations
Header files
Using Server-Library sample programs
Purpose of the sample programs
Location
Sample program summaries
ctos.c sample program
exfds.c sample program
fullpass.c sample program
intlchar.c sample program
lang.c sample program
multthrd.c sample program
osintro.c sample program
regproc.c sample program
secsrv.c sample program
sigalarm.c sample program
Open Client Embedded SQL/C
General instructions
Building an Embedded SQL/C executable
Precompiling the application
Compiling and linking the application
Additional considerations
Loading stored procedures
Using Embedded SQL/C sample programs
Purpose of the sample programs
Location
Header file
Example 1: Using cursors for database query
Example 2: Displaying and editing rows of a table
ExampleHA: Using cursors for database query with HA-Failover
Uni_example1: Using cursors for database query with unichar/univarchar support
Uni_example2: Displaying and editing rows of a table with unichar/univarchar support
Open Client Embedded SQL/COBOL
General instructions
Building an Embedded SQL/COBOL executable
Libraries
Precompiling the application
Compiling and linking the application
Additional considerations
Data alignment on a 64-bit architecture
Loading stored procedures
Using Embedded SQL/COBOL sample programs
Purpose of the sample programs
Location
Example 1: Using cursors for database query
Example 2: Displaying and editing rows in a table
Utility Commands Reference
bcp
cpre
cobpre
defncopy
isql
installjava
extractjava
Environment Variables
Programmers Supplement Open Client and Open Server 15.0 for Windows
About this book
Building Open Client and Open Server Applications
Open Client and Open Server requirements
C compilers
Client-Library compatibility
Open Server compatibility
Environment variables and header files
Header files
Import libraries and Dynamic Link Libraries (DLLs)
Import libraries
Dynamic link libraries (DLLs)
Configuration requirements
Platform-specific default values
Client-Library programming issues
ct_callback
Using the debug DLLs
Multithreaded support
Example compile-and-link operations
DB-Library programming issues
Compile-and-link line examples
Server-Library programming issues
srv_callback
Scheduling modes
Preemptive mode programming overview
srv_sleep
srv_wakeup
Example of compile-and-link operations
Client-Library/C Sample Programs
Using Client-Library sample programs
Before you begin
Location of the sample programs
Header files
example.h file
Sample program summaries
Utility routines for the sample programs
First sample program
Modified first sample program
Array bind sample program
Asynchronous sample program
Bulk copy sample program
Compute rows sample program
Directory service sample program
External configuration sample program
Implicit read-only cursor sample program
Localization and internationalization sample program
Multithreaded sample program
Read-only cursor sample program
Read-only cursor modified sample program
RPC command sample program
Modified RPC command sample program
Security service sample program
Scrollable cursors sample program
Modified scrollable cursors sample program
text and image sample program
Two phase commit sample program
unichar and univarchar bulk-copy sample program
unichar and univarchar compute sample program
Wide tables compute sample program
Wide tables cursor sample program
Wide table dynamic data sample program
Wide table RPC command sample program
Open Client DB-Library/C Sample Programs
Using DB-Library sample programs
Before you begin
Location of the sample programs
Header files
sybdbex.h header file
Sample program summaries
Send queries, bind, and print results sample program
Insert data into new table sample program
Bind aggregate and compute results sample program
Row buffering sample program
Data conversion sample program
Browse mode updates sample program
Browse mode and ad hoc queries sample program
RPC call sample program
Text and image sample program
Insert image sample program
Retrieve image sample program
International language routines sample program
Bulk copy sample program
Two-phase commit sample program
Open Server Server-Library/C Sample Programs
Using Server-Library sample programs
Before you begin
Location and content
Tracing
Header files
Sample program summaries
Testing sample programs
Open Server introduction sample program
Gateway Open Server sample program
srv_language event handler sample program
TDS passthrough mode sample program
Registered procedures sample program
International languages and character sets sample program
Multithreaded programming sample program
Security services sample program
Open Client Embedded SQL/C
Building an Embedded SQL/C executable
Precompiling the application
Compiling and linking the application
Link libraries
Loading stored procedures
Using Embedded SQL/C sample programs
Before you begin
Header file
Example 1: Using cursors for database query
Example 2: Displaying and editing rows of a table
ExampleHA: Using cursors for database query with HA-Failover
Uni_example1: Using cursors for database query with unichar/univarchar support
Uni_example2: Displaying and editing rows of a table with unichar/univarchar support
Open Client Embedded SQL/COBOL
Building an Embedded SQL/COBOL executable
Precompiling the application
Compiling and linking the application
Link libraries
Loading stored procedures
Using Embedded SQL/COBOL sample programs
General requirements
Environment variables for Micro Focus COBOL
Example 1: Using cursors for database query
Example 2: Displaying and editing rows in a table
Utility Commands Reference
bcp
defncopy
isql
instjava
extrjava
Precompiler Reference
cpre
cobpre
New Features Open Server and SDK 15.0 for Windows, Linux, and UNIX
Product platforms and compatibilities
Product components
Open Server
Software Developer’s Kit
SDK DB-Library Kerberos Authentication option
IPv6 support
Character set support
Upgrading to the new version
New feature ESD #19
DBPROP_MAXROWS support
New feature in ESD #18
isql command history
Activating command history
Listing command history
Recalling and reissuing commands
New features in ESD #17
New isql command line option --appname
New CT-Library debug flag CS_DBG_SSL
New environment variables for controlling CT-Library debugging
jConnect support for Transact-SQL queries with COMPUTE clause
New feature in ESD #16
Support for Kazakh character set kz1048
New features in ESD #15
SSL Plus 5.2.2 and SBGSE 2.2 support
Open Server support for connection migration
In-batch migration and idle migration
Context migration
Modified Open Server API
New Open Server APIs
Error messages
Instructing clients to migrate to a different server
Accepting connections from migrated clients
Support for partial update of text and image columns
Client-Library usage
Open Server usage
New features in ESD #14
LDAP schema for Microsoft Active Directory
Importing the directory schema
Creating a container for Sybase server entries
Support for ESQL/C and ESQL/COBOL 64-bit applications
Compiler build mode
Data alignment on a 64-bit architecture
New ESQL/COBOL veneer layer libraries
New font option for Open Server and SDK installers
Using the -font command line option
Using the font.ini file
Extended platform support for the ASE ODBC Driver by Sybase
New jConnect scripts to access SQL Anywhere metadata
Enhancement to the jConnect extended password encryption
New feature in ESD #13
isql support for obfuscated input
New features in ESD #12
New cs_config properties
CS_SYBASE_HOME
CS_LIBTCL_CFG
CS_DEFAULT_IFILE
isql and bcp enhancement
isql support for dynamic redirection of T-SQL output
jConnect, ODBC, OLEDB and ADO.NET support for Adaptive Server Cluster Edition
Login redirection
Connection migration
Connection failover enhancement
New feature in ESD #11
SSL enhancement for common name validation
New features in ESD #10
Kerberos support using Windows SSPI
Credential delegation for MIT Kerberos
New isql command line option --retserverror
New BCP command line option --skiprows
ct_data_info() enhancement
ADO.NET 2.0 support
BCP insert support
Password expiration handling for ADO.NET, ODBC and OLE DB
Password expiration handling in ASE ADO.NET 2.0
Password expiration handling in ODBC and OLE DB
Mainframe Connect and DirectConnect for z/OS Option support
ServiceName configuration property
BackEndType configuration property
Updates and clarifications
Update to ESD #9
Update to ESD #8
Modification to section “SSL Plus 5.0.4 + SBGSE 2.0”
New feature in ESD #9
Release of 32-bit binaries for 64-bit products on UNIX platforms
Using strings to check the EBF number of 64-bit products
New features in ESD #8
bcp discard file support for rejected rows
-e errorfile extended functionality
Support for cached interfaces file
Support for ESQL structures and arrays as indicator variables
Open Client migration
Implementation
Extended password encryption
Enabling extended password encryption for ASE ODBC, OLE DB, and ADO.NET
Enabling extended password encryption for the jConnect for JDBC Driver
Password expiration handling for jConnect for JDBC
Extended support for secure LDAP connections using SSL/TLS
Extended platform support for ASE OLE DB Provider
New features in ESD #7
Extended password encryption
CS_SEC_EXTENDED_ENCRYPTION
CS_SEC_NON_ENCRYPTION_RETRY
CS_EXTENDED_ENCRYPT_CB
SRV_NEG_EXTENDED_ENCRYPT, SRV_NEG_EXTENDED_LOCPWD, and SRV_NEG_EXTENDED_REMPWD
SRV_EXTENDED_ENCRYPT
Sybase customized Open SSL support
New array indicator feature in ESQL/C
Extended BCP support for encrypted columns
bcp syntax changes
Support for secure LDAP connections using SSL/TLS
Extended support for OpenLDAP
New srv_send_data routine added
New features in ESD #6
New LDAP Directory Server retry and delay options
Unsafe Null with indicator variables in ESQL/C
New logging feature for ASE OLE DB Provider
Updates and clarifications
New features in ESD #5
Timeout support for LDAP
Large identifier capability check in Open Server
BCP support for initialization strings
RPC support for large identifiers
Open Client updates
Open Server updates
Updated Server-Library routines
MIT Kerberos on DB-Library
JDBC 3.0 features support in jConnect 6.05
Savepoint support
Retrieval of parameter metadata
Retrieval of auto-generated keys
Ability to have multiple open ResultSet objects
Passing parameters to CallableStatement objects by name
Holdable cursor support
New property GET_COLUMN_LABEL_FOR_NAME
New features in ESD #4
SSL Plus support on Linux AMD64 (Opteron)/EM64T and HP Itanium 32-bit and 64-bit, Sun Solaris 10 x64 32-bit and 64-bit
Extended support for MIT Kerberos
ESQL/COBOL support on HP Itanium 32-bit
Login redirection and extended HA failover support on Open Server
srv_send_ctlinfo
srv_getserverbyname
srv_freeserveraddrs
Extended support for OpenLDAP
Asynchronous execution for ODBC
Documentation updates and clarifications to ESD #1
New features in ESD #3
ESQL/COBOL support for scrollable cursors
DECLARE statement
OPEN statement
FETCH statement
Examples
Extended support for MIT Kerberos
ESQL/COBOL support on Linux x86 32-bit
HA failover on ASE OLE DB Provider
Using failover in HA systems
Confirming a successful failover
Verifying an unsuccessful failover
New jConnect 6.05 connection properties
New features in ESD #2
Open Server support for scrollable cursors
New SRV_CURDESC2 scrollable cursor structure
New srv_cursor_props2 routine added
New scrollable cursor command options
Extended support for MIT Kerberos
Extended support for OpenLDAP
ASE OLE DB Provider participation in Distributed Transactions
Programming for MS DTC
Programming components deployed in MTS or COM+
Connection properties for Distributed Transaction support
OLE DB DSN Migration tool available
Using the Sybase ASE Data Source Administrator
Using the DSN Migration tool
New features in ESD #1
Embedded SQL/C scrollable cursors
Declaring cursors
Fetching data
Declaring a scrollable cursor and fetching rows
BCP support for encrypted columns
BCP and ISQL support for alternative trusted.txt file location
Client-Library migration samples available
Directory services sql.ini and interface file support
Connection string
ODBC DSN Migration tool available
Using the Migration tool
Conversion switches
Bookmark and bulk support for ODBC and OLE DB
Sybase interfaces and sql.ini file support for jConnect
Modifying the connection string
Open Server 15.0 and SDK 15.0 features
Open Client and Open Server 15.0 features
Sybase library names changed
Directory structure for this version
Socket/tli drivers embedded in network library
Unilib supported
New datatypes supported
Server packet size increased
BCP partition support for multiple-partition, multiple-file operations
BCP support for computed columns
Dynamic version of bulk library available
Large identifiers supported
IPv6 supported
Client-Library scrollable cursors
Supported COBOL compiler version changed
SSL Plus 5.0.4 + SBGSE 2.0
DB-Library changes
New environment variable
SDK 15.0 features for the ASE Drivers and Data Providers
Migrating to ASE ODBC Driver by Sybase and ASE OLE DB Provider by Sybase
ADO.NET Data Provider directory change and migration
New datatypes
Computed columns supported
Large identifiers supported
Server-side scrollable cursors supported
ASE default network packet size increased
Default client character set changed (Linux only)
SSL Plus 5.0.4 + SBGSE 2.0 support on Windows
SDK 15.0 features for jConnect
New datatypes supported
Computed columns supported
Large identifiers supported
Scrollable cursors supported
ASE default network packet size increased
Accessibility features
Open Client DB-Library/C Reference Manual
About this book
Introducing DB-Library
Client/server architecture
Types of clients
Types of servers
The Open Client and Open Server products
Open Client
Open Server
Open Client libraries
What is in DB-Library/C?
Comparing the library approach to Embedded SQL
Data structures for communicating with servers
DB-Library/C programming
DB-Library/C datatypes
DB-Library/C routines
Initialization
Initializing DB-Library/C
Setting up the LOGINREC
Establishing a server connection
Command processing
Building the command batch
Accessing the command batch
Executing the command batch
Setting and clearing command options
Results processing
Setting up the results
Getting result data
Reading result rows
Canceling results
Handling stored procedure results
Setting results timeouts
Message and error handling
Information retrieval
Regular result column information
Compute result column information
Row buffer information
Command state information
Browse mode
Text and image handling
Datatype conversion
Process control flow
Remote procedure call processing
Registered procedure call processing
Gateway passthrough routines
Datetime and money
Cleanup
Secure support
Miscellaneous routines
Two-phase commit service special library
MIT Kerberos on DB-Library
Summary of changes for version 15.0
Recompiling older DB-Library applications
Sample programs
Routines
db12hour
dbadata
dbadlen
dbaltbind
dbaltbind_ps
dbaltcolid
dbaltlen
dbaltop
dbalttype
dbaltutype
dbanullbind
dbbind
dbbind_ps
dbbufsize
dbbylist
dbcancel
dbcanquery
dbchange
dbcharsetconv
dbclose
dbclrbuf
dbclropt
dbcmd
DBCMDROW
dbcolbrowse
dbcollen
dbcolname
dbcolsource
dbcoltype
dbcoltypeinfo
dbcolutype
dbconvert
dbconvert_ps
DBCOUNT
DBCURCMD
DBCURROW
dbcursor
dbcursorbind
dbcursorclose
dbcursorcolinfo
dbcursorfetch
dbcursorinfo
dbcursoropen
dbdata
dbdate4cmp
dbdate4zero
dbdatechar
dbdatecmp
dbdatecrack
dbdatename
dbdateorder
dbdatepart
dbdatezero
dbdatlen
dbdayname
DBDEAD
dberrhandle
dbexit
dbfcmd
DBFIRSTROW
dbfree_xlate
dbfreebuf
dbfreequal
dbfreesort
dbgetchar
dbgetcharset
dbgetloginfo
dbgetlusername
dbgetmaxprocs
dbgetnatlang
dbgetoff
dbgetpacket
dbgetrow
DBGETTIME
dbgetuserdata
dbhasretstat
dbinit
DBIORDESC
DBIOWDESC
DBISAVAIL
dbisopt
DBLASTROW
dbload_xlate
dbloadsort
dblogin
dbloginfree
dbmny4add
dbmny4cmp
dbmny4copy
dbmny4divide
dbmny4minus
dbmny4mul
dbmny4sub
dbmny4zero
dbmnyadd
dbmnycmp
dbmnycopy
dbmnydec
dbmnydivide
dbmnydown
dbmnyinc
dbmnyinit
dbmnymaxneg
dbmnymaxpos
dbmnyminus
dbmnymul
dbmnyndigit
dbmnyscale
dbmnysub
dbmnyzero
dbmonthname
DBMORECMDS
dbmoretext
dbmsghandle
dbname
dbnextrow
dbnpcreate
dbnpdefine
dbnullbind
dbnumalts
dbnumcols
dbnumcompute
DBNUMORDERS
dbnumrets
dbopen
dbordercol
dbpoll
dbprhead
dbprrow
dbprtype
dbqual
DBRBUF
dbreadpage
dbreadtext
dbrecftos
dbrecvpassthru
dbregdrop
dbregexec
dbreghandle
dbreginit
dbreglist
dbregnowatch
dbregparam
dbregwatch
dbregwatchlist
dbresults
dbretdata
dbretlen
dbretname
dbretstatus
dbrettype
DBROWS
DBROWTYPE
dbrpcinit
dbrpcparam
dbrpcsend
dbrpwclr
dbrpwset
dbsafestr
dbsechandle
dbsendpassthru
dbservcharset
dbsetavail
dbsetbusy
dbsetconnect
dbsetdefcharset
dbsetdeflang
dbsetidle
dbsetifile
dbsetinterrupt
DBSETLAPP
DBSETLCHARSET
DBSETLENCRYPT
DBSETLHOST
DBSETLMUTUALAUTH
DBSETLNATLANG
DBSETLNETWORKAUTH
dbsetloginfo
dbsetlogintime
DBSETLPACKET
DBSETLPWD
DBSETLSERVERPRINCIPAL
DBSETLUSER
dbsetmaxprocs
dbsetnull
dbsetopt
dbsetrow
dbsettime
dbsetuserdata
dbsetversion
dbspid
dbspr1row
dbspr1rowlen
dbsprhead
dbsprline
dbsqlexec
dbsqlok
dbsqlsend
dbstrbuild
dbstrcmp
dbstrcpy
dbstrlen
dbstrsort
dbtabbrowse
dbtabcount
dbtabname
dbtabsource
DBTDS
dbtextsize
dbtsnewlen
dbtsnewval
dbtsput
dbtxptr
dbtxtimestamp
dbtxtsnewval
dbtxtsput
dbuse
dbvarylen
dbversion
dbwillconvert
dbwritepage
dbwritetext
dbxlate
Errors
Options
Types
Bulk Copy Routines
Introduction to bulk copy
Transferring data into the database
Transferring data out of the database to a flat file
List of bulk copy routines
bcp_batch
bcp_bind
bcp_colfmt
bcp_colfmt_ps
bcp_collen
bcp_colptr
bcp_columns
bcp_control
bcp_done
bcp_exec
bcp_getl
bcp_init
bcp_moretext
bcp_options
bcp_readfmt
bcp_sendrow
BCP_SETL
bcp_setxlate
bcp_writefmt
Two-Phase Commit Service
Programming distributed transactions
The commit service and the application program
The probe process
Two-phase commit routines
Specifying the commit server
Two-phase commit sample program
Program notes
Program note 1
Program note 2
Program note 3
Program note 4
Program note 5
Program note 6
Program note 7
Program note 8
abort_xact
build_xact_string
close_commit
commit_xact
open_commit
remove_xact
scan_xact
start_xact
stat_xact
Cursors
Cursor overview
DB-Library cursor capability
Differences between DB-Library cursors and browse mode
Differences between DB-Library and Client-Library cursors
Sensitivity to change
Static cursor
Keyset-driven cursor
Dynamic cursor
Concurrency control
DB-Library cursor functions
Holding locks
Stored procedures used by DB-Library cursors
Open Client Client-Library/C Programmers Guide
About this book
Getting Started with Client-Library
Client-Library overview
Types of Client-Library applications
Adaptive Server client applications
Open Server client or gateway applications
Summary of changes for version 15.0
A simple sample program
Building programs
Steps in the example
Source listing
Step 1: Set up the Client-Library programming environment
Header files
Allocating a context structure
Setting CS-Library context properties
Initializing Client-Library
Setting Client-Library context properties
External configuration
Step 2: Define error handling
Step 3: Connect to a server
Allocating a connection structure
Setting connection structure properties
Required connection properties
Logging in to a server
Step 4: Send commands to the server
Allocating a command structure
Setting command structure properties
Executing a command
Step 5: Process the results of the command
Step 6: Finish
Deallocating command structures
Closing and deallocating connections
Exiting Client-Library
Deallocating a context structure
Understanding Structures, Constants, and Conventions
Hidden structures
CS_CONTEXT
CS_CONNECTION
CS_COMMAND
Control structure hierarchy
Connection and command rules
CS_LOGINFO
CS_DS_OBJECT
CS_BLKDESC
CS_LOCALE
Exposed structures
CS_BROWSEDESC
CS_CLIENTMSG
CS_DATAFMT
CS_DATEREC
CS_IODESC
CS_SERVERMSG
SQLCA, SQLCODE, and SQLSTATE
SQLDA
Constants
Type constants
Format constants
Other symbolic constants
Conventions
NULL and unused parameters
Pointer parameters
Non-pointer parameters
Input parameter strings
Output parameter strings
Pointers to basic structures
Item numbers
action, buffer, buflen, and outlen
Using Open Client and Server Datatypes
Types and type constants
Where are datatypes declared?
Why use Open Client and Open Server datatypes?
unichar datatype
Datatypes and capabilities
isql and bcp utilities
Limitations
unitext datatype
Datatypes and capabilities
isql and bcp utilities
Limitations
xml datatype
Datatypes and capabilities
isql and bcp utilities
Limitations
What are type constants?
Datatype summary
Binary types
Bit types
Character types
Datetime types
Numeric types
Money types
Text and image types
Null substitution values
Open Client user-defined datatypes
Handling Errors and Messages
About messages
How to identify messages
Client-Library messages and Client-Library return codes
Server messages and message results
Two methods for handling messages
Combining the methods
Handling messages with callback routines
Defining a client-message callback
Defining a server-message callback
Installing callbacks
Handling messages inline
The CS_EXTRA_INF property
The CS_DIAG_TIMEOUT_FAIL property
Sequencing long messages
Extended error data
Uses of extended error data
Server transaction states
Choosing Command Types
Command overview
Types of commands
Executing commands
Initiating a command
Defining parameters for a command
Processing results
Resending a command
Language commands
Building language commands
Results-handling for language commands
When to use language commands
When not to use language commands
RPC commands
Building RPC commands
RPC command results handling
Return parameter values
Return status values
When to use RPC commands
RPCs versus execute language commands
Client-Library cursor commands
Building Client-Library cursor commands
When to use Client-Library cursors
When not to use Client-Library cursors
Dynamic SQL commands
Building Dynamic SQL commands
When to use dynamic SQL commands
When not to use dynamic SQL
Message commands
When to use message commands
When not to use message commands
Package commands
Send-data commands
When to use send-data commands
When not to use send-data commands
Writing Results-Handling Code
Types of results
Structure of the basic loop
Processing regular row results
Processing cursor results
Processing scrollable cursor results
Processing parameter results
Processing return status results
Processing compute results
Processing message results
Processing describe results
Processing format results
Values of result_type that indicate command status
Logical commands
ct_results final return code
Using Client-Library Cursors
Cursor overview
Language cursors versus Client-Library cursors
Language cursors
Client-Library cursors
When to use Client-Library cursors
Benefits of Client-Library cursors
Nested cursor commands
Commands executed using a different command structure
Performance issues when using Client-Library cursors
Using Client-Library cursors
Step 1: Declare the cursor
Declaring a cursor to directly execute a select statement
Declaring a cursor to execute a stored procedure
Declaring a cursor to execute a prepared dynamic SQL statement
Step 2: Set cursor rows
Step 3: Open the cursor
Cursor command batching
Reopening a cursor
Step 4: Process cursor rows
Nested cursor-update or cursor-delete commands
Nested cursor-close commands
Sending commands on a different command structure
Step 5: Close the cursor
Step 6: Deallocate the cursor
Client-Library cursor properties
Using Dynamic SQL Commands
Dynamic SQL overview
Benefits of dynamic SQL
Limitations of dynamic SQL
Performance of dynamic SQL commands
Adaptive Server restrictions and database requirements
Alternatives to dynamic SQL
Using the execute-immediate method
When to use the execute-immediate method
Coding an execute-immediate command
Using the prepare-and-execute method
When to use prepare-and-execute method
Program structure for the prepare-and-execute method
Step 1: Prepare the statement
Step 2: Get a description of command inputs
Initiating a describe-input command
Processing parameter descriptions
Step 3: Get a description of command outputs
Initiating a describe-output command
Processing column descriptions
Step 4: Execute the prepared statement
Step 5: Deallocate the prepared statement
Dynamic SQL versus stored procedures
Using Directory Services
Directory service overview
How do applications use a directory service?
Searching the directory
Example code
Program structure
Step 1: Starting the search
Initialize data structures
Setting directory service properties
Installing the directory callback
Calling ct_ds_lookup
Example code to start a directory search
Step 2: Collecting search results in the directory callback
Defining the directory callback
Directory callback example
Step 3: Inspecting directory objects
Attribute data structures
Example code to inspect a directory object
Retrieving an attributes value
Processing attribute values
Step 4: Cleaning up
Logical Sequence of Calls
Client-Library state machines
Command-level sequence of calls
Commands state table
Initiated-commands state table
Result-types state table
Summary
Command states
Command-level routines
Callable routines in each command state
Initiated commands
Initiated command routines
Callable routines for initiated commands
Result types
Result type processing routines
Callable routines for each result type
Pending results
Open Client Client-Library/C Reference Manual
About this book
Introducing Client-Library
Sybase client/server architecture
Types of clients
Types of servers
Open Client and Open Server products
Open Client
Open Server
Shared common libraries
CS-Library
Bulk-Library
Client-Library is a generic interface
Comparing the library approach to Embedded SQL
What an application developer needs to know
Programming interfaces
Getting started
Summary of changes for version 15.0
Client-Library Topics
Asynchronous programming
Asynchronous applications
Asynchronous routines
The CS_BUSY return code
Completions
Deferred asynchronous completions
Fully asynchronous completions
Client-Library’s interrupt-level memory requirements
Layered applications
Using ct_wakeup and CS_DISABLE_POLL
An example
Browse mode
Using Browse mode
The Browse mode where clause
Browse mode conditions
Callbacks
Callback types
Callbacks are not always supported
Installing a callback routine
When a callback event occurs
Retrieving and replacing callback routines
Restrictions on Client-Library calls in callbacks
Declaring callbacks with CS_PUBLIC
Client message callbacks
Defining a client message callback
Client message callback example
Completion callbacks
Defining a completion callback
Directory callbacks
Defining a directory callback
Directory search results processing
Callback invocation sequence
Directory callback example
Encryption callbacks
Defining an encryption callback
Negotiation callbacks
Challenge/response security handshakes
Defining a negotiation callback
Notification callbacks
Defining a notification callback
Retrieving notification parameters
Security session callbacks
Establishing a direct security session
Defining a security session callback
Server message callbacks
Defining a server message callback
Server message callback example
Handling specific messages
Signal callbacks
Defining a signal callback
Installing a signal callback
SSL validation callbacks
Defining an SSL validation callback
SSL validation callback example
Capabilities
Wide tables and larger page size
Page size
Wide tables
unichar datatype
Datatypes and capabilities
isql and bcp utilities
Limitations
unitext datatype
Datatypes and capabilities
isql and bcp utilities
Limitations
xml datatype
Datatypes and capabilities
isql and bcp utilities
Limitations
Capabilities and the connection’s TDS level
Setting and retrieving capabilities
Setting and retrieving multiple capabilities
Client-Library and SQL Structures
Exposed and hidden structures
Exposed structures
Hidden structures
CS_BROWSEDESC structure
CS_CLIENTMSG structure
Client-Library message numbers
CS_DATAFMT structure
CS_IODESC structure
CS_OID structure
Encoding of object identifiers
Definition of the CS_OID structure
Using predefined OID strings
CS_SERVERMSG structure
SQLCA structure
SQLCODE structure
Mapping server messages to SQLCODE
Mapping Client-Library messages to SQLCODE
SQLSTATE structure
Commands
Sending commands
Initiating a command
Defining parameters for a command
Sending a command
Resending a command
Deciding which type of command to use
Connection migration
Directory services
Directory service providers and drivers
Network-based directory services
LDAP
OpenLDAP
SSL/TLS
LDAP Directory Server lookup time limit
LDAP for Microsoft Active Directory
Use of the directory by applications
Directory organization
Directory entry name formats
Name syntax for DCE CDS
Name syntax for Windows Registry
Name syntax for LDAP directory services
Name syntax for the Interfaces file
Locating entries with a DIT base
Viewing directory entries
Directory objects
Properties for directory services
Error handling
Error reporting during initialization
cs_ctx_alloc and cs_ctx_global
ct_init
Error and message handling
Two methods of handling messages
Using callbacks to handle messages
Inline message handling
Client-Library message structures
The CS_EXTRA_INF property
Sequencing long messages
Message structure fields for sequenced messages
Sequenced messages and extended error data
Sequenced messages and ct_diag
Extended error data
Uses for extended error data
Retrieving extended error data
Server message callbacks and extended error data
Inline error handling and extended error data
Server transaction states
Retrieving transaction states in mainline code
Retrieving transaction states in a server message callback
Sample programs
Client-Library routines in sample programs
Header files
High-availability failover
Add hafailover line to interfaces file
Client-Library application changes
Using isql with Sybase Failover
Interfaces file
Overview of Interfaces file entries
Server objects from the Interfaces file
International Support
When an application needs to use a CS_LOCALE structure
Using a CS_LOCALE structure
Context-level localization
Connection-level localization
Data-element level localization
Locating localization information
The locales file
Locales file entries
cs_locale and the locales file
Macros
Decoding a message number
Manipulating bits in a CS_CAP_TYPE structure
Using the sizeof operator
Prototyping functions
Multithreaded applications: signal handling
Basic concepts
Signal handling in nonthreaded environments
Types of signals
Signal handlers
Signal masking
Signal delivery
Using sigwait to handle asynchronous signals
Special Sybase signal handlers
SIGTRAP signal
Using Sun’s ALARM and SETITIMER routines
Multithreaded programming
What is a thread
Benefits of multiple threads
Types of threads
Write thread-safe code
Serializing access to shared data and shared resources
Synchronizing dependent actions
Calling thread-unsafe system routines
Avoiding deadlock
Client-Library restrictions for multithreaded programs
Calling context-level routines
Context initialization and cleanup
CS-Library error handling
Calling connection-level routines
Using CS_LOCALE structures
Coding thread-safe callback routines
Threads and fully asynchronous mode
Multithreaded programming models for Client-Library
One-thread, one-connection model
Worker-thread model
Other thread models
Options
Setting options externally
Properties
Comparing properties, options, and capabilities
Login properties
Setting and retrieving properties
Three kinds of context properties
Checking whether a property is supported
Copying login properties
Setting properties externally
Properties quick reference table
About the properties
ANSI-style binds
Application name
Asynchronous notifications
Bulk copy operations
Character set conversion
Communications session block
Connection status
Configure by server name
Configuration file name
Connection migration
Cursor ID
Cursor name
Cursor rowcount
Cursor status
Diagnostic timeout fail
Disable poll
Directory service properties
Extended error data command structure
Extended failover
Endpoint polling
Expose formats
External configuration
Extra information
Have bindings
Have resendable command
Have restorable cursor-open command
Hidden keys
Host name
Location of the interfaces file
Locale information
Login status
Login timeout
Loop delay
Login redirection
Maximum number of connections
Memory pool
Network I/O
No truncate
No API checking
No character conversion required
No interrupt
Packet size
Parent structure
Partial updates to text and image data
Password
Persistent result bindings
Retry count
Security properties
Server name
TDS version
Text and image limit
Timeout
Transaction name
User allocation function
User free function
User data
User name
Version string for Client-Library
Version of Client-Library
Registered procedures
When Client-Library receives a notification
Receiving notifications asynchronously
Finding out about notifications
Results
Regular row results
Cursor row results
Parameter results
Stored procedure return status results
Compute row results
Message results
Describe results
Format results
Program structure for processing results
Retrieving an item’s value
Keeping result bindings for batch processing
Selecting multiple rows of variable length data into an array
Security features
Network-based security
Security mechanisms and security drivers
Choosing a network security mechanism
Requesting network security services
Secure Sockets Layer in Open Client and Open Server
Internet communications overview
Public-key cryptography
SSL overview
SSL handshake
SSL in Open Client and Open Server
SSL filter
Validating the server by its certificate
The trusted roots file
Obtaining a certificate
Adaptive Server security features
Security handshaking: Challenge/Response
Security handshaking: encrypted password
Server directory object
Use of the server directory object
Contents of the server directory object
Format of object attributes
List of attributes
Server entry version
Server name attribute
Service description
Server status
Transport address
Security mechanisms
Server objects from the interfaces file
Server restrictions
Open Server restrictions
Adaptive Server restrictions
Supported client/server features
text and image data handling
Retrieving a text or image column
Using ct_get_data to fetch text and image values
Updating a text or image column
Retrieving the I/O descriptor settings
Sending the new column value
Partial updates to text and image data
Populating a table containing text or image columns
Smaller text and image values
Larger text and image values
Server global variables for text and image updates
Using global variables to update a text or image column
Datatypes support
Datatype summary
Routines that manipulate datatypes
Open Client datatypes
Binary types
Bit types
Character types
XML type
Datetime types
Integer types
Real, float, numeric, and decimal types
Money types
Text and image types
Open Client user-defined datatypes
Using the runtime configuration file
Enabling debugging
Enabling external configuration
Open Client and Open Server runtime configuration file syntax
Runtime configuration file keywords
Keywords for localization
Keywords for context or connection properties
Keywords for server options
Keywords for server capabilities
Keywords for ct_debug options
Routines
ct_bind
ct_br_column
ct_br_table
ct_callback
ct_cancel
ct_capability
ct_close
ct_cmd_alloc
ct_cmd_drop
ct_cmd_props
ct_command
ct_compute_info
ct_con_alloc
ct_con_drop
ct_con_props
ct_config
ct_connect
ct_cursor
ct_data_info
ct_debug
ct_describe
ct_diag
ct_ds_dropobj
ct_ds_lookup
ct_ds_objinfo
ct_dynamic
ct_dyndesc
ct_dynsqlda
ct_exit
ct_fetch
ct_get_data
ct_getformat
ct_getloginfo
ct_init
ct_keydata
ct_labels
ct_options
ct_param
ct_poll
ct_recvpassthru
ct_remote_pwd
ct_res_info
ct_results
ct_scroll_fetch
ct_send
ct_send_data
ct_sendpassthru
ct_setloginfo
ct_setparam
ct_wakeup
Glossary
Open Client Client-Library Migration Guide
About this book
Understanding Client-Library
What is Client-Library?
Comparing the client interfaces
What is unique about Client-Library?
Tight integration with Open Server
Client interface to server-side cursors
Client interface to dynamic SQL
Asynchronous mode
Non-polling (interrupt-driven)
Polling
Multithreaded application support
Support for network-based security and directory services
Security services
Directory services
Where to go for more information
User-defined datatypes and conversion routines
Localization mechanisms
Streamlined interface
What’s new in Client-Library
Evaluating an Application for Migration
Questions to consider
Will the application benefit from migration?
How much effort will the migration require?
Summary
Planning for Migration
Get software
Learn about Client-Library
Familiarize yourself with sample programs
Isolate DB-Library code
Consider application redesign
Unified results handling
Cursors
Array binding
Asynchronous mode
Multithreading
Review your estimate of the migration effort
Plan for testing
Develop a schedule
Check your environment
Comparing DB-Library and Client-Library Infrastructures
Utility routines
Header files
Control structures
Control structure properties
Inherited property values
Setting property values
The CS_CONTEXT structure
The CS_CONNECTION structure
The CS_COMMAND structure
Connection and command rules
Other structures
CS_DATAFMT
CS_IODESC
CS_LOCALE
CS_BLKDESC
Converting DB-Library Application Code
Conversion steps
Initialization and cleanup code
Comparing call sequences
Example: Client-Library initialization and cleanup
Code that opens a connection
Comparing call sequences
Client-Library enhancements
Migrating LOGINREC code
Example: Opening a Client-Library connection
Error and message handlers
Sequenced messages
Replacing server message handlers
Replacing DB-Library error handlers
Error handler return values
Code that sends commands
Sending language commands
Client-Library enhancements
Example: Sending a Client-Library language command
Sending RPC commands
Client-Library enhancements
Example: sending an RPC command
TDS passthrough
Code that processes results
Program structure for results processing
Comparing dbresults and ct_results return codes
Handling command-processing errors
Comparing ct_results’ result_type to DB-Library program logic
Retrieving data values
ct_bind versus dbbind
ct_get_data versus dbdata
Getting descriptions of result data
Obtaining Results Statistics
Obtaining the Command Number (DBCURCMD)
Obtaining the Number of Rows Affected
Obtaining the number of the current row
Canceling results
CS_CANCEL_ATTN
CS_CANCEL_ALL
CS_CANCEL_CURRENT
Advanced Topics
Client-Library’s array binding
Using Array Binding
Array Binding Example
Client-Library cursors
Comparing DB-Library and Client-Library cursors
Rules for Processing Cursor Results
Comparing Cursor Routines
DB-Library fetch types and Client-Library cursors
Using ct_keydata
Comparing Client-Library cursors to Browse Mode Updates
Using Array Binding with Cursors
Client-Library cursor example
Asynchronous programming
DB-Library’s Limited Asynchronous Support
Client-Library asynchronous support
Using ct_poll
Using ct_wakeup
Bulk copy interface
Bulk-Library initialization and cleanup
Transfer routines
Other differences from DB-Library bulk copy
Text/Image interface
Retrieving text or image data
DB-Library’s text timestamp
Client-Library’s CS_IODESC structure
Sending text or image data
Text and image examples
Localization
CS_LOCALE Structure
Localization precedence
Mapping DB-Library Routines to Client-Library Routines
Mapping DB-Library routines to Client-Library routines
Open Client Embedded SQL/C Programmers Guide
About this book
Introduction
Embedded SQL overview
Embedded SQL features
New features and enhancements
New datatypes supported
Scrollable cursors supported
Transact-SQL support in Embedded SQL
Getting started
Using the examples
Backward compatibility
Creating and running an Embedded SQL program
How the precompiler processes your applications
Multiple Embedded SQL source files
Precompiler compatibility
Precompiler-generated files
General Information
Five tasks of an Embedded SQL program
Simplified Embedded SQL program
General rules for Embedded SQL
Statement placement
Comments
Identifiers
Quotation marks
Reserved words
Variable naming conventions
Scoping rules
Statement batches
Embedded SQL constructs
Communicating with Adaptive Server
Scoping rules: SQLCA, SQLCODE, and SQLSTATE
Declaring SQLCA
Multiple SQLCAs
SQLCA variables
Accessing SQLCA variables
SQLCODE within SQLCA
Declaring SQLCODE as a standalone area
Using SQLSTATE
Obtaining SQLSTATE codes and error messages
Summary
Using Variables
Declaring variables
Using datatypes
Using type definitions
Type Definitions and Limits
Using #define
Declaring an array
Declaring character arrays
Declaring unions and structures
Using host variables
Host input variables
Host result variables
Host status variables
Host output variables
Using indicator variables
Indicator variables and server restrictions
Using host variables with indicator variables
Using indicator variables with host output and result variables
Using indicator variables with host input variables
Host variable conventions
Using arrays
Multiple arrays
Scoping rules
Datatypes and Adaptive Server
Converting datatypes
Converting datatypes for result variables
Converting datatypes for input variables
Connecting to Adaptive Server
Connecting to a server
user
password
connection_name
server
connect example
Changing the current connection
Establishing multiple connections
Naming a connection
Invalid statements with the at clause
Using Adaptive Server connections
Disconnecting from a server
Using Transact-SQL Statements
Transact-SQL statements in Embedded SQL
exec sql syntax
Invalid statements
Transact-SQL statements that differ in Embedded SQL
Selecting rows
Selecting one row
Selecting multiple rows using arrays
select into arrays
Indicators with array fetches
Arrays and structures as indicator variables
fetch into batch arrays
Selecting multiple rows using cursors
Cursor scoping rules
Declaring cursors
Declaring scrollable cursors
Opening cursors
Fetching data using cursors
Fetching data using scrollable cursors
Using cursors to update and delete rows
Closing cursors
Cursor example
Using stored procedures
User-defined stored procedures
Precompiler-generated stored procedures
Grouping statements
Grouping statements by batches
Grouping statements by transactions
Transact-SQL transaction mode
Default ANSI/ISO transaction mode
Extended transactions
Using Dynamic SQL
Dynamic SQL overview
Dynamic SQL protocol
Method 1: Using execute immediate
Method 1 examples
Method 2: Using prepare and execute
prepare
execute
Method 2 example
Method 3: Using prepare and fetch with a cursor
prepare
declare
open
fetch and close
Method 3 example
Method 4: Using prepare and fetch with dynamic descriptors
Method 4 dynamic descriptors
Dynamic descriptor statements
About SQL descriptors
Method 4 example using SQL descriptors
About SQLDAs
Method 4 example using SQLDAs
Summary
Handling Errors
Testing for errors
Using SQLCODE
Testing for warning conditions
Trapping errors with whenever
whenever testing conditions
whenever actions
Using get diagnostics
Writing routines to handle warnings and errors
Precompiler-detected errors
Improving Performance with Persistent Binding
About persistent binding
When binding occurs
Programs that can benefit from persistent binding
Scope of persistent bindings
Precompiler options for persistent binding
The -p option
The -b option
Which option to use: -p, -b, or both
Scope of the -p and -b precompiler options
Overview of rules for persistent binding
Statements that can use persistent binding
Persistent binding in statements without a cursor
Persistent binding in statements with a cursor
Preventing persistent binding for all cursor host variables
Requesting persistent binding for all cursor host variables
Requesting persistent binding for cursor output variables only
Requesting persistent binding for cursor input variables only
Persistent binding, cursors, and multiple source files
Persistent binding and cursor fetch statements
Guidelines for using persistent binding
Notes on the binding of host variables
Subscripted arrays
Scope of host variables
Embedded SQL Statements: Reference Pages
allocate descriptor
begin declare section
begin transaction
close
commit
connect
deallocate cursor
deallocate descriptor
deallocate prepare
declare cursor (dynamic)
declare cursor (static)
declare cursor (stored procedure)
declare scrollable cursor
delete (positioned cursor)
delete (searched)
describe input (SQL descriptor)
describe input (SQLDA)
describe output (SQL descriptor)
describe output (SQLDA)
disconnect
exec
exec sql
execute
execute immediate
exit
fetch
fetch scrollable cursor
get descriptor
get diagnostics
include "filename"
include sqlca
include sqlda
initialize_application
open (dynamic cursor)
open (static cursor)
prepare
rollback
select
set connection
set descriptor
thread exit
update
whenever
Open Client and Open Server Configuration File
Purpose of the Open Client and Open Server configuration file
Accessing the configuration functionality
Default settings
Syntax for the Open Client and Open Server configuration file
Sample programs
Embedded SQL/C sample makefile on Windows
Embedded SQL/C sample programs
Embedded SQL program version for use with the -x option
Same Embedded SQL program with the -e option
Summary
Precompiler Warning and Error Messages
Sample Code for Handling Large Text and Image Data
Where to find other samples
text_image.sql
text_image.cp
Glossary
Open Client Embedded SQL/COBOL Programmers Guide
About this book
Introduction
Embedded SQL overview
Embedded SQL features
New features and enhancements
New datatypes supported
Scrollable cursors supported
Transact-SQL support in Embedded SQL
Getting started
Using the examples
Backward compatibility
Creating and running an Embedded SQL program
How the precompiler processes your applications
Multiple Embedded SQL source files
Precompiler-generated files
Group element referencing
General Information
Five tasks of an Embedded SQL program
Simplified Embedded SQL program
General rules for Embedded SQL
Statement placement
Comments
Identifiers
Quotation marks
Reserved words
Variable naming conventions
Scoping rules
Statement batches
Embedded SQL constructs
Communicating with Adaptive Server
Scoping rules: SQLCA, SQLCODE, and SQLSTATE
Declaring SQLCA
Multiple SQLCAs
SQLCA variables
Accessing SQLCA variables
SQLCODE within SQLCA
Declaring SQLCODE as a standalone area
Using SQLSTATE
Obtaining SQLSTATE codes and error messages
Using Variables
Declaring variables
Declaring a character array
Using host variables
Host input variables
Host result variables
Host status variables
Host output variables
Using indicator variables
Indicator variables and server restrictions
Using host variables with indicator variables
Using indicator variables with host output and result variables
Using indicator variables with host input variables
Host variable conventions
Using arrays
Multiple arrays
Scoping rules
Datatypes
Elementary data items
Group data items
Special data items
Comparing COBOL and Adaptive Server datatypes
Converting datatypes
Converting datatypes for result variables
Converting datatypes for input variables
Connecting to Adaptive Server
Connecting to a server
user
password
connection_name
server
connect example
Changing the current connection
Establishing multiple connections
Naming a connection
Invalid statements with the at clause
Using Adaptive Server connections
Disconnecting from a server
Using Transact-SQL Statements
Transact-SQL statements in Embedded SQL
exec sql syntax
Invalid statements
Transact-SQL statements that differ in Embedded SQL
Selecting rows
Selecting one row
Selecting multiple rows through arrays
select into arrays
Indicator arrays
Arrays and structures as indicator variables
fetch into: batch arrays
Cursors and arrays
Using cursors
Cursor scoping rules
Declaring cursors
Example: Declaring a cursor
Declaring scrollable cursors
Opening cursors
Fetching data using cursors
Fetching data using scrollable cursors
Using cursors to update and delete rows
Closing cursors
Cursor example
Using stored procedures
User-defined stored procedures
Precompiler-generated stored procedures
Grouping statements
Grouping statements by batches
Grouping statements by transactions
Transact-SQL transaction mode
Default ANSI/ISO transaction mode
Extended transactions
Including files and directories
Using Dynamic SQL
When to use dynamic SQL
Dynamic SQL protocol
Method 1: Using execute immediate
Method 1 examples
Method 2: Using prepare and execute
prepare
execute
Method 2 example
Method 3: Using prepare and fetch with a cursor
prepare
declare
open
fetch and close
Method 3 example
Method 4: Using prepare and fetch with system descriptors
Method 4 dynamic descriptors
Dynamic descriptor statements
About SQL descriptors
Method 4 example
About SQLDAs
Using SYBSETSQLDA
Syntax
Returns
Method 4 example using SQLDAs
Handling Errors
Testing for errors
Using SQLCODE
Testing for warning conditions
Trapping errors with the whenever statement
whenever testing conditions
whenever actions
Using get diagnostics
Writing routines to handle warnings and errors
Precompiler-detected errors
Embedded SQL Statements: Reference Pages
allocate descriptor
begin declare section
begin transaction
close
commit
connect
deallocate cursor
deallocate descriptor
deallocate prepare
declare cursor (dynamic)
declare cursor (static)
declare cursor (stored procedure)
declare scrollable cursor
delete (positioned cursor)
delete (searched)
describe input (SQL descriptor)
describe input (SQLDA)
describe output (SQL descriptor)
describe output (SQLDA)
disconnect
exec
exec sql
execute
execute immediate
exit
fetch
scroll fetch
get descriptor
get diagnostics
include “filename”
include sqlca
include sqlda
initialize_application
open (dynamic cursor)
open (static cursor)
open scrollable cursor
prepare
rollback
select
set connection
set descriptor
update
whenever
Open Client/Server Configuration File
Purpose of the Open Client/Server configuration file
Accessing the configuration functionality
Default settings
Syntax for the Open Client/Server configuration file
Syntax
Sample programs
Embedded SQL/COBOL sample programs
Embedded SQL program version for use with the -x option
Same Embedded SQL program with the -e option
Precompiler Warning and Error Messages
Understanding the codes in the tables
Glossary
Open Client and Open Server Common Libraries Reference Manual
About this book
Introducing CS-Library
CS-Library overview
Using CS-Library
Open Client and Open Server applications
A standalone CS-Library application
Structures
CS_CONTEXT structure
Datatypes, constants, and conventions
Error handling
Two methods of handling messages
Using a callback to handle messages
Defining a CS-Library message callback
CS-Library message callback example
Inline message handling
Summary of changes for version 15.0
CS-Library Routines
cs_calc
cs_cmp
cs_config
cs_conv_mult
cs_convert
cs_ctx_alloc
cs_ctx_drop
cs_ctx_global
cs_diag
cs_dt_crack
cs_dt_info
cs_loc_alloc
cs_loc_drop
cs_locale
cs_manage_convert
cs_objects
cs_prop_ssl_localid
cs_set_convert
cs_setnull
cs_strbuild
cs_strcmp
cs_time
cs_validate_cb
cs_will_convert
Bulk-Library
Overview of Bulk-Library
Client-side and server-side routines
Client-side Bulk-Library routines
Server-side Bulk-Library routines
Header files
Linking with Bulk-Library
The CS_BLKDESC structure
Bulk-Library client programming
Bulk-copy-in operations
The bulk-copy-in process
Program structure for bulk-copy-in operations
Bulk-copy-out operations
The bulk-copy-out process
Program structure for bulk-copy-out operations
Copying to and from Secure Adaptive Server
Bulk-Library gateway programming
Inside the SRV_LANGUAGE event handler
“Insert Bulk” requests
“Writetext Bulk” requests
Inside the SRV_BULK event handler
Example
Bulk-Library Routines
blk_alloc
blk_bind
blk_colval
blk_default
blk_describe
blk_done
blk_drop
blk_getrow
blk_gettext
blk_init
blk_props
blk_rowalloc
blk_rowdrop
blk_rowxfer
blk_rowxfer_mult
blk_sendrow
blk_sendtext
blk_srvinit
blk_textxfer
Open Client and Open Server International Developers Guide
About this book
Understanding Internationalization and Localization
Internationalization and localization
Advantages of internationalized applications
International systems
Open Client and Open Server support for international systems
How Localization Works
Deciding what localization values to use
Using initial localization values
Setting up an application to use initial localization values
Using custom localization values
Localization mechanism details
The locales file
Environment variables
Platforms not using environment variables
The CS_LOCALE structure
The cs_locale routine
Example: Calling cs_locale to Load a CS_LOCALE structure
Writing Internationalized Open Client and Open Server Applications
Writing internationalized Client-Library applications
Client-Library applications using initial values
Client-Library applications using custom values
Customizing at the context level
Example
Defining custom localization values for a context
Customizing at the connection level
Example
Defining custom localization values for a connection
Customizing at the data element level
Example
Defining custom localization values at the data element level
Client-Library localization value precedence
Client-Library localization properties
Writing internationalized Open Server applications
Localizing the application
Open Server applications using initial values
Open Server applications using custom values
Supporting localized clients
Automatic support for localized clients
Additional support for localized clients
Responding to requests to change language and character set
Server-Library localization properties
Writing internationalized DB-Library applications
Internationalizing with Embedded SQL
Localizing the precompiler
How default values are determined
Specifying custom localization values
Localizing an Embedded SQL application
Localizing standalone utilities
Tips
Make sure required files are installed
Using CS_NULLTERM with Open Client and Open Server routines
Coded Character Set Conversion Support
Definitions
Supported character sets
Understanding coded character set conversion
Establishing the language and character set for a connection
Disabling character set conversion
Using Open Server as a conversion gateway
Files used during character set conversion
Unilib library
Using custom coded character set conversion
Why install custom conversion routines?
Writing a custom conversion routine
Installing a custom conversion routine
Character set conversion in Adaptive Server releases prior to 4.9
Mainframe support
Changes in this version
New Unilib library
Elimination of table-driven character conversion
Editing the Locales File
Quick start
When to edit the locales file
Locales file sections and entries
Locale definition entries
Locales file example
Editing the locales file
Adding or changing entries
Deleting entries
Creating or Changing Collating Sequences
Quick start
About collating sequences
Definitions
Types of sorts
Determining case sensitivity
When to create a custom collating sequence file
About collating sequence files
Collating sequence file sections and entries
Writing characters in a collating sequence file
The preference keyword and the order by clause
Creating a custom collating sequence file
Collating sequence file example
Directories and Files Related to Internationalization
Overview
The locales directory
The locales file
Localized message files
language_name subdirectories
Unicode directory
The charsets directory
Collating sequence files
Unicode conversion files
The config and ini directories
The global object identifiers file
Object identifiers file sections and entries
Object identifiers file example
Editing object identifiers file
External Localization File Syntax
Localization file syntax rules
Localization file sections
Example localization file
Glossary
Open Server Server-Library/C Reference Manual
About this book
Introducing Open Server
Client/Server overview
Types of clients
Types of servers
Open server configurations
Standalone open server application
Auxiliary open server application
Gateway Open Server application
Open Server
The Open Server libraries
Network services
Using Open Server
The CS_CONTEXT structure
Steps in a simple program
Basic Open Server program
Open Server events
Default event handlers
Non client-initiated events
Registered procedures
Returning results to clients
Types of result data
Messages
Data rows
Parameters
Status values
Order of results
Error handling
Multithread programming
Summary of changes for version 15.0
Topics
Attention events
Interrupt-level activity
Coding recommendations for attention events
Handling disconnects
Example
Browse mode
Example
Capabilities
Request capabilities
Response capabilities
Transparent negotiation
When does transparent negotiation take place?
Server-wide defaults
Explicit negotiation
Negotiating capabilities one at a time
Negotiating using a capability bitmask
Capability macros
Ad hoc retrieval of capability information
A note on pre-10.0 clients
Example
Client command errors
Sending messages with srv_sendinfo
Sequencing long messages
CS_SERVERMSG structure fields for sequenced messages
Extended error data
What is extended error data good for?
Sending extended error data to a client
Connection migration
In-batch migration and idle migration
Context migration
APIs used in connection migration
CS_REQ_MIGRATE
SRV_CTL_MIGRATE
SRV_MIGRATE_RESUME
SRV_MIGRATE_STATE
SRV_T_MIGRATE_STATE property and SRV_MIG_STATE enumerated type
SRV_T_MIGRATED
SRV_T_SESSIONID
Instructing clients to migrate to a different server
Requesting a client to migrate
Managing the connect (SRV_CONNECT) event
Managing the migrate state (SRV_MIGRATE_STATE) event
Sharing client context
Managing the migrate resume (SRV_MIGRATE_RESUME) event
Managing the disconnect (SRV_DISCONNECT) event
Managing in-batch migration
Attention handling
Disconnecting Open Server
Accepting connections from migrated clients
Error messages
CS_BROWSEDESC structure
CS_DATAFMT structure
CS_IODESC structure
CS-Library
Common routines
Common data structures
Error handling
CS_SERVERMSG structure
Cursors
Cursor overview
Advantages of cursors
Open Server applications and cursors
How are cursor requests generated?
Types of cursor commands
How is cursor information exchanged with a client?
SRV_CURDESC structure
Values for curstatus
Values for curcmd
Handling cursor requests
How to respond to specific requests
Key data
Update columns
Example
Scrollable cursors
SRV_CURDESC2 structure
Values for curstatus
Values for curcmd
srv_cursor_props2 routine
Data stream messages
Data stream messages overview
Retrieving client data stream messages
Sending data stream messages to a client
Directory services
Specifying a directory driver
Registering an Open Server application with a directory
Dynamic SQL
Advantages of dynamic SQL
Handling dynamic SQL requests
The srv_dynamic routine
Detecting a command type
Responding to client dynamic SQL commands
Example
Errors
Types of errors
Severity of errors
Operating system errors
Error numbers and corresponding message text
Example
Events
Event overview
What is an event handler?
Default and custom handlers
Coding custom handlers
Standard events
Programmer-defined events
Example
Gateway applications
Passthrough mode
International support
Localizing an Open Server application
Supporting localized clients
Using a CS_LOCALE structure to set custom localization values
Localizing CS-Library messages for clients
Creating localized connections for gateway applications
Localizing a CS_CONTEXT structure
Responding to client requests
Requests to change language and character set
Requests for localization information
Localization properties
Localization examples
Language calls
Login redirection and extended HA failover support
Messages
Multithread programming
What is a thread?
Thread types
Preemptive threads
Thread-safe functions
Thread-safe code and preemptive mode
Implementation specifics
Event-driven threads
Service threads
Site-handler threads
Scheduling
Scheduling methods
Selecting a thread to resume
Tools and techniques
Mutexes
Message queues
Protecting critical sections
Callback routines
Programming considerations
Example
Negotiated behavior
Login negotiations
Transparent negotiation
Explicit negotiation
Negotiating a secure connection
Ad hoc negotiations
Example
Options
Inside the SRV_OPTION event handler
Option descriptions and default values
Example
Partial update
Open Server set-up
sp_mda
SRV_T_BULKTYPE
Handlers
Passthrough mode
Regular passthrough mode
Negotiating the TDS protocol level in passthrough mode
Using regular passthrough mode
Example
Event handler passthrough mode
Coding and installing a full passthrough event handler
Enabling event handler passthrough mode for a thread
Negotiating the TDS protocol level
Processing parameter and row data
A note on terminology
The Open Server data processing model
Retrieving parameters
Returning rows
Returning return parameters
A closer look at describing, binding, and transferring
Describing
Binding
Transferring
Automatic conversion
Returning parameters in a language data stream
Example
Properties
Context properties
Server properties
SRV_S_TDSVERSION
SRV_S_TRACEFLAG
Thread properties
SRV_T_BULKTYPE
SRV_T_CHARTYPE
SRV_T_ENDPOINT
SRV_T_EVENT
SRV_T_FLTTYPE
SRV_T_LOGINTYPE
SRV_T_MIGRATED
SRV_T_MIGRATE_STATE
SRV_T_RMTPWDS
SRV_T_SESSIONID
SRV_T_TDSVERSION
SRV_T_TYPE
Registered procedures
Standard remote procedure calls
Advantages of registered procedures
Notification procedures
Creating registered procedures
The mechanics of registered procedures
Registering procedures
Executing registered procedures
Maintaining lists
System registered procedures
Using callback handlers with registered procedures
Example
Remote procedure calls
Example
Security services
Security service properties
Login authentication services
Per-packet security services
SSL overview
How do security services work with Open Server?
Steps involved in a Client/Server dialog using security services
Using security mechanisms with Open Server applications
Security drivers
libtcl.cfg configuration file
Object identifiers
Changes to the interfaces file
Changes to the interfaces file: the SSL filter
Determining which security services are active
Scenarios for using security services with Open Server applications
Simple application using a security session
Gateway application with separate security sessions
Gateway with separate security sessions using delegation
Full passthrough gateway with direct security session
Text and image
Processing text and image data
Retrieving data from a client
Returning data to a client
Example
Types
Routines that manipulate datatypes
Open Server datatypes
Binary types
Bit type
Character types
XML type
Datetime types
Integer types
Real, float, numeric, and decimal types
Money types
Security types
Text and image types
Routines
srv_alloc
srv_alt_bind
srv_alt_descfmt
srv_alt_header
srv_alt_xferdata
srv_bind
srv_bmove
srv_bzero
srv_callback
srv_capability
srv_capability_info
srv_createmsgq
srv_createmutex
srv_createproc
srv_cursor_props
srv_dbg_stack
srv_dbg_switch
srv_define_event
srv_deletemsgq
srv_deletemutex
srv_descfmt
srv_dynamic
srv_envchange
srv_event
srv_event_deferred
srv_free
srv_freeserveraddrs
srv_get_text
srv_getloginfo
srv_getmsgq
srv_getobjid
srv_getobjname
srv_getserverbyname
srv_handle
srv_init
srv_langcpy
srv_langlen
srv_lockmutex
srv_log
srv_mask
srv_msg
srv_negotiate
srv_numparams
srv_options
srv_orderby
srv_poll (UNIX only)
srv_props
srv_putmsgq
srv_realloc
srv_recvpassthru
srv_regcreate
srv_regdefine
srv_regdrop
srv_regexec
srv_reginit
srv_reglist
srv_reglistfree
srv_regnowatch
srv_regparam
srv_regwatch
srv_regwatchlist
srv_rpcdb
srv_rpcname
srv_rpcnumber
srv_rpcoptions
srv_rpcowner
srv_run
srv_s_ssl_local_id
srv_select (UNIX only)
srv_send_ctlinfo
srv_send_data
srv_send_text
srv_senddone
srv_sendinfo
srv_sendpassthru
srv_sendstatus
srv_setcolutype
srv_setcontrol
srv_setloginfo
srv_setpri
srv_signal (UNIX only)
srv_sleep
srv_spawn
srv_symbol
srv_tabcolname
srv_tabname
srv_termproc
srv_text_info
srv_thread_props
srv_timedsleep
srv_ucwakeup
srv_unlockmutex
srv_version
srv_wakeup
srv_xferdata
srv_yield
System Registered Procedures
sp_ps
sp_regcreate
sp_regdrop
sp_reglist
sp_regnowatch
sp_regwatch
sp_regwatchlist
sp_serverinfo
sp_terminate
sp_who
Glossary
ASE 15.0 ADO.NET Users Guide
About this book
Understanding and Deploying ASE ADO.NET Data Provider
What is ASE ADO.NET Data Provider?
Deploying ASE ADO.NET Data Provider
Supported development platforms
Supported deployment platforms
System requirements
Required files
Deploying ASE ADO.NET Data Provider assembly into the global assembly cache
Removing the assembly from GAC
Deploying applications that use ASE ADO.NET Data Provider
Updating to a newer version of ADO.NET Data Provider
Using the configuration files to redirect CLR
Using application configuration files
Using Publisher policy files
Deploying updates to the Data Provider
Deploying Data Provider into the GAC
Deploying Data Provider when it is not in the GAC
Running the sample projects
Using the Sample Applications
Tutorial: Using the Simple code sample
Understanding the Simple sample project
Tutorial: Using the Table Viewer code sample
Understanding the Table Viewer sample project
Tutorial: Using the Advanced code sample
Understanding the Advanced sample project
Developing Applications
Using Data Provider in a Visual Studio .NET project
Adding a reference to the Data Provider assembly
Referencing ASE ADO.NET Data Provider classes
Connecting to a database
Connection pooling
Checking the connection state
Accessing and manipulating data
Using AseCommand to retrieve and manipulate data
Getting data using the AseCommand object
Inserting, updating, and deleting rows using the AseCommand object
Obtaining DataReader schema information
Using AseDataAdapter to access and manipulate data
Getting data using the AseDataAdapter object
Inserting, updating, and deleting rows using the AseDataAdapter object
Obtaining AseDataAdapter schema information
Obtaining primary key values
Handling BLOBs
Obtaining time values
Using stored procedures
Transaction processing
Error handling
ASE Advanced Features
Using Distributed Transactions
Programming using Enterprise Services
Connection properties for Distributed Transaction support
Directory services
LDAP as a directory service
Using directory services
Password encryption
Using SSL
SSL in ASE ADO.NET Data Provider
Validating the server by its certificate
Enabling SSL connections
Using failover in a high-availability system
Using Kerberos authentication
Process overview
Requirements
Enabling Kerberos authentication
Enabling Kerberos on Windows
Obtaining an initial ticket from the Key Distribution Center
ASE ADO.NET Data Provider API Reference
AseCommand class
AseCommand constructors
Cancel method
CommandText property
CommandTimeout property
CommandType property
Connection property
CreateParameter method
ExecuteNonQuery method
ExecuteReader method
ExecuteScalar method
ExecuteXmlReader method
NamedParameters
Parameters property
Prepare method
Transaction property
UpdatedRowSource property
AseCommandBuilder class
AseCommandBuilder constructors
DataAdapter property
DeriveParameters method
GetDeleteCommand method
GetInsertCommand method
GetUpdateCommand method
QuotePrefix property
QuoteSuffix property
RefreshSchema method
AseCommandBuilder class
DeleteCommand property
Dispose method
InsertCommand property
SelectCommand property
UpdateCommand property
AseConnection class
AseConnection constructors
BeginTransaction method
ChangeDatabase method
Close method
ConnectionString property
ConnectionTimeout property
CreateCommand method
Database property
InfoMessage event
NamedParameters
Open method
State property
StateChange event
TraceEnter, TraceExit events
AseDataAdapter class
AseDataAdapter constructors
AcceptChangesDuringFill property
ContinueUpdateOnError property
DeleteCommand property
Fill method
FillError event
FillSchema method
GetFillParameters
InsertCommand property
MissingMappingAction property
MissingSchemaAction property
RowUpdated event
RowUpdating event
SelectCommand property
TableMappings property
Update method
UpdateCommand property
AseDataReader class
Close method
Depth property
Dispose method
FieldCount property
GetBoolean method
GetByte method
GetBytes method
GetChar method
GetChars method
GetDataTypeName method
GetDateTime method
GetDecimal method
GetDouble method
GetFieldType method
GetFloat method
GetInt16 method
GetInt32 method
GetList method
GetName method
GetOrdinal method
GetSchemaTable method
GetString method
GetUInt16 method
GetUInt32 method
GetUInt64 method
GetValue method
GetValues method
IsClosed property
IsDBNull method
Item property
NextResult method
Read method
RecordsAffected property
AseDbType enum
AseError class
ErrorNumber property
Message property
SqlState property
ToString method
AseErrorCollection class
CopyTo method
Count property
Item property
AseException class
Errors property
Message property
AseFailoverException class
Errors property
Message property
ToString method
AseInfoMessageEventHandler delegate
AseParameter class
AseParameter constructors
AseDbType property
DbType property
Direction property
IsNullable property
ParameterName property
Precision property
Scale property
Size property
SourceColumn property
SourceVersion property
ToString method
Value property
AseParameterCollection class
Add method
Clear method
Contains method
CopyTo method
Count property
IndexOf method
Insert method
Item property
Remove method
RemoveAt method
AsePermission class
AsePermission constructors
AsePermissionAttribute class
AsePermissionAttribute constructor
CreatePermission method
AseRowUpdatedEventArgs class
AseRowUpdatedEventArgs constructors
Command property
Errors property
RecordsAffected property
Row property
StatementType property
Status property
TableMapping property
AseRowUpdatingEventArgs class
AseRowUpdatingEventArgs constructors
Command property
Errors property
Row property
StatementType property
Status property
TableMapping property
AseRowUpdatedEventHandler delegate
AseRowUpdatingEventHandler delegate
AseTransaction class
Commit method
Connection property
IsolationLevel property
Rollback method
ASE 15.0 ODBC Driver by Sybase Users Guide for Windows, Linux and Mac OS X
About this book
Introduction to ODBC Programming
Introduction to ODBC
ODBC conformance
ODBC Driver Manager
Building applications using an ODBC Driver Manager
Building applications without using an ODBC Driver Manager
Using the ASE ODBC Driver samples
Defining ODBC handles
Allocating ODBC handles
Connecting to a data source
Choosing an ODBC connection function
Establishing a connection
Using threads and connections in ODBC applications
Executing SQL statements
Executing statements directly
Executing statements with bound parameters
Executing prepared statements
Working with result sets
Choosing cursor characteristics
Retrieving data
Updating and deleting rows through a cursor
Using scrollable cursors
Setting the UseCursor connection property
Support for the Static Insensitive scrollable cursor
Setting scrollable cursor attributes
Executing scrollable cursors
Looking at results
Implicit setting of scrolling cursor attributes
Calling stored procedures
Handling errors
Datatype mappings
Using computed columns
Using server-specified packet size
Using Large Identifiers for database objects
Connecting to a Database
Introduction to connections
Installing ODBC MetaData stored procedures
How connection parameters work
Character sets
Configuring the ASE ODBC Driver
Windows
Registering the ASE ODBC Driver on Windows
Configuring a data source on Windows
Linux
Installing the ASE ODBC Driver on Linux
Configuring a data source on Linux
Mac OS X
Manually configuring the ODBC Driver on Mac OS X
Configuring a data source on Mac OS X
ODBC ini files
Windows
Linux
Mac OS X
Connecting using a data source
Using connection parameters
ASE Advanced Features
Asynchronous execution for ODBC
Supported Adaptive Server Cluster Edition features
Login redirection
Connection migration
Connection failover in Cluster Edition
Enabling Cluster Edition connection failover
Using Distributed Transactions
Programming for MS DTC
Programming components deployed in Sybase EAServer, MTS, or COM+
Connection properties for Distributed Transaction support
Using directory services
LDAP as a directory service
Using directory services
Enabling directory services
Linux
Mac OS X
Bookmark and bulk support
DSN Migration tool
Using the Migration tool
Conversion switches
Using password encryption
Windows
Linux
Mac OS X
Password expiration handling
Using SSL
SSL security levels in ASE ODBC Driver
Validating the server by its certificate
Enabling SSL connections
Windows
Linux
Mac OS X
Using failover in high availability systems
Windows
Linux
Mac OS X
Enabling Kerberos authentication
Process overview
Requirements
Enabling Kerberos authentication
Windows
Linux
Obtaining an initial ticket from the Key Distribution Center
ASE 15.0 OLE DB Provider Users Guide
About this book
Introduction to ASE OLE DB Provider
Introduction to OLE DB
Supported platforms
ADO programming with ASE OLE DB Provider
Connecting to a database using the Connection object
Executing statements using the Command object
Querying the database with the Recordset object
Working with the Rowset object
Using transactions
Supported OLE DB interfaces
OLE DB programming with ASE OLE DB Provider
Connecting to a data source using OLE DB
Using threads and connections in OLE DB applications
Executing SQL statements
Executing statements directly
Executing statements with bound parameters
Executing prepared statements
Working with result sets
Retrieving data
Using scrollable cursors
Setting the UseCursor connection property
Setting scrollable cursor attributes
Executing scrollable cursors
Looking at results
Example of scrollable static insensitive cursor program
Calling stored procedures
Handling errors
Mapping datatypes
Using computed columns
Using large identifiers for database objects
Connecting to a Database
Introduction to connections
How connection parameters work
Connection parameters passed as connection strings
Using connection parameters
Connecting from ADO
Example
ASE Advanced Features
Directory services
LDAP as a directory service
Using directory services
Password encryption
Data encryption using SSL
SSL security levels in ASE OLE DB Provider
Validating the server by its certificate
Enabling SSL connections
Kerberos authentication
Process overview
Requirements
Enabling Kerberos authentication
Windows
Obtaining an initial ticket from the Key Distribution Center
XA Interface Integration Guide for CICS, Encina, and TUXEDO
About this book
Introduction
Overview
Requirements
The Sybase XA Environment
Definitions
Overview of the X/Open DTP model
Components of the model
How the components communicate
How the components interact
Recovery
The Sybase XA environment
Components of the Sybase XA environment
Connections in the Sybase XA environment
Identifying connections via LRMs
Where is the connection information stored?
Establishing connections
Distributing work across LRMs
Configuring the XA Environment
Configuring Adaptive Server
Open string parameters for DTM XA Interface
Open string parameters
dtm_tm_role required for username
Log file and trace flag parameters
Labels for logfile entries
xa_open() function behavior
XA configuration file for DTM XA Interface
Environment variable for specifying configuration file
[all] section for defining common LRM parameters
Parameter definitions for [all] section
Editing the XA configuration file
Additional capabilities, properties, and options
Using the DTM XA Interface with CICS
Building the switch-load file
Compiling the switch-load file on IBM RISC System/6000 AIX
Compiling the switch-load file on HP9000 Series 800 HP-UX
Compiling the switch-load file on Sun Solaris 2.x (SPARC)
Adding a Sybase stanza to the CICS region XAD definition
Using the DTM XA Interface with Encina
Assigning an open string with monadmin create rm
Initializing LRMs with mon_RegisterRmi
Linking applications with DTM XA Interface libraries
Establishing connections
Using the DTM XA Interface with TUXEDO
Linking
Setting up the UBBCONFIG file
Creating the TUXEDO configuration file
Building the TMS
Build COBOL runtime environment
Application Programming Guidelines
X/Open DTP versus traditional Sybase transaction processing
Transaction and connection management
Transaction management
Connection management
The current connection
Nontransactional connections
Deallocate cursor function with Client-Library
Dynamic SQL
Getting a Client-Library connection handle
Multiple-thread environment issues
Caveats of thread use
Embedded SQL thread-safe code
Tightly coupled transactions
Linking with CT Library
Sample embedded SQL COBOL fragment
Sample embedded SQL C fragment
Release Bulletin jConnect for JDBC 6.05
Accessing current release bulletin information
Product summary
Special installation instructions
Check your jConnect version
Special upgrade instructions
Migration
Version setting
JDK 1.4
Changed functionality in this version
Known problems
Unsupported JDBC 2.0 and JDBC 3.0 functions
Stored procedures executed from JDBC clients
IOException for setBinaryStream
Output from queries with errors
allTablesAreSelectable method returns incorrect information
Handling numeric errors returned as warnings
Documentation updates and clarifications
Technical support
Other sources of information
Sybase certifications on the Web
Sybase EBFs and software maintenance
Accessibility features
Installation Guide jConnect for JDBC 6.05
About this book
Installing jConnect for JDBC
Reviewing system requirements
Windows requirements
UNIX and Linux requirements
Installing jConnect for JDBC
Install JDK or JRE
Install jConnect products
Set environment variables
Setting JDBC_HOME
Setting the CLASSPATH
Install stored procedures
On an Adaptive Server Enterprise database
On a SQL Anywhere or Adaptive Server Anywhere database
Review the installation contents
Packages
Directories and files
JDBC 2.0 samples
JDBC 3.0 conformance
Test the jConnect installation
Verifying the jConnect version
Upgrading jConnect
Using jConnect Documentation
Programmer’s reference
Java documentation of jConnect extensions to JDBC
jConnect documentation access using index.html files
jisql and Ribo documentation
Programmers Reference jConnect for JDBC 6.05
About this book
Introduction
What is JDBC?
What is jConnect?
Programming Information
Setting up jConnect
Setting the jConnect version
Invoking the jConnect driver
Configuring jConnect for J2EE servers
Establishing a connection
Connection properties
Setting connection properties
Listing current connection settings
List of jConnect connection properties
Connecting to Adaptive Server
URL connection property parameters
Using the sql.ini and interfaces file directory services
Connection string for a single DSURL for jConnect
Format of the sql.ini and interfaces file for SSL
Connecting to a server using JNDI
Connection URL for using JNDI
Required directory service information
CONNECTION_FAILOVER connection property
Providing JNDI context information
Implementing custom socket plug-ins
Creating and configuring a custom socket
Example
Handling internationalization and localization
Using jConnect to pass Unicode data
jConnect character-set converters
Selecting a character-set converter
Setting the CHARSET connection property
Improving character-set conversion performance
Supported character sets
European currency symbol support
Unsupported character sets
Working with databases
Implementing high availability failover support
Overview
Requirements, dependencies, and restrictions
Implementing failover in jConnect
Performing server-to-server remote procedure calls
Using wide table support for Adaptive Server
Accessing database metadata
Server-side metadata installation
Using cursors with result sets
Creating a cursor
Using JDBC 1.x methods for positioned updates and deletes
Using JDBC 2.0 methods for positioned updates and deletes
Using a cursor with a PreparedStatement object
Using TYPE_SCROLL_INSENSITIVE result sets in jConnect
Using Transact-SQL queries with COMPUTE clause
Support for batch updates
Implementation notes
Updating a database from a result set of a stored procedure
Working with datatypes
Sending numeric data
Updating image data in the database
Using text data
Using date and time datatypes
Using char/varchar/text datatypes and getByte
Implementing advanced features
JDBC 3.0 features support in jConnect 6.05
Savepoint support
Retrieval of parameter metadata
Retrieval of autogenerated keys
Ability to have multiple open ResultSet objects
Passing parameters to CallableStatement objects by name
Holdable cursor support
Using BCP insert
Supported Adaptive Server Cluster Edition features
Login redirection
Connection migration
Connection failover
Using event notification
Event notification example
Handling error messages
Handling numeric errors returned as warnings
Retrieving Sybase-specific error information
Customizing error-message handling
Installing an error-message handler
Error-message-handler example
Using password encryption
Enabling password encryption
Enabling login retry with a clear text password
Setting up the Java Cryptography Extension (JCE) provider
Using GSE-J to perform RSA password encryption
Storing Java objects as column data in a table
Prerequisites for storing java objects as column data
Sending Java objects to a database
Receiving Java objects from the database
Using dynamic class loading
Using DynamicClassLoader
Using deserialization
Preloading .jar files
Advanced features
JDBC 2.0 optional package extensions support
JNDI for naming databases
Connection pooling
Distributed transaction management support
Restrictions on and interpretations of JDBC standards
Using JDBC 3.0 method stubs
Using Connection.isClosed and IS_CLOSED_TEST
Using Statement.close with unprocessed results
Making adjustments for multithreading
Using ResultSet.getCursorName
Using setLong with large parameter values
Datatypes supported
Bigint datatype
Unitext datatypes
Unsigned int datatypes
Executing stored procedures
Security
Overview
Restrictions
SSL
Kerberos
Configuring jConnect applications for Kerberos
GSSMANAGER_CLASS connection property
Vendor implementations
Setting GSSMANAGER_CLASS
Examples
Setting up the Kerberos environment
CyberSafe
MIT
Microsoft Active Directory
Sample applications
ConnectKerberos.java
The krb5.conf configuration file
CyberSafe or MIT KDC
Active Directory KDC
Interoperability
Encryption types
Troubleshooting
Kerberos
Related documents
Troubleshooting
Debugging with jConnect
Obtaining an instance of the Debug class
Turning on debugging in your application
Turning off debugging in your application
Setting the CLASSPATH for debugging
Using the Debug methods
Capturing TDS communication
PROTOCOL_CAPTURE connection property
pause and resume methods in the Capture class
Resolving connection errors
Gateway connection refused
Managing memory in jConnect applications
Resolving stored procedure errors
RPC returns fewer output parameters than registered
Fetch/state errors when output parameters are returned
Stored procedure executed in unchained transaction mode
Resolving a custom socket implementation error
Performance and Tuning
Improving jConnect performance
BigDecimal rescaling
REPEAT_READ connection property
SunIoConverter character-set conversion
Performance tuning for prepared statements in dynamic SQL
Choosing prepared statements and stored procedures
Prepared statements in portable applications
Prepared statements with jConnect extensions
If most dynamic statements are executed infrequently
If most dynamic statements are executed many times in a session
Connection.prepareStatement
DYNAMIC_PREPARE connection property
SybConnection.prepareStatement
ESCAPE_PROCESSING_DEFAULT connection property
Cursor performance
LANGUAGE_CURSOR connection property
Migrating jConnect Applications
Migrating applications to jConnect 6.x
Changing Sybase extensions
Extension change example
Method names
Debug class
Web Server Gateways
About Web server gateways
Using TDS tunnelling
Configuring jConnect and gateways
Web server and Adaptive Server on one host
Dedicated JDBC Web server and Adaptive Server on one host
Web server and Adaptive Server on separate hosts
Connecting to a server through a firewall
Usage requirements
Reading the index.html file
Running the sample Isql applet
Troubleshooting
Using the TDS-tunnelling servlet
Reviewing requirements
Installing the servlet
Setting servlet arguments
Invoking the servlet
Tracking active TDS sessions
Terminating TDS sessions
Resuming a TDS session
Using TDS and Netscape Enterprise Server 3.5.1 on Solaris
SQL Exception and Warning Messages
jConnect Sample Programs
Running IsqlApp
Running jConnect sample programs and code
Sample applications
Running the sample applets
Running the sample programs with SQL Anywhere
Sample code
Open Server 12.5.1
Open Server 12.5.1 (Chinese-Simplified)
Open Server 12.5.1 (French)
OpenSwitch 15.1
SAP Sybase PowerAMC 16.5 SP03
SAP Sybase PowerAMC 16.5 SP02
PowerAMC 16.5
PowerAMC 16.1
PowerAMC 16.0
PowerBuilder 12.5.2
PowerBuilder 12.5.1
PowerBuilder 12.5
PowerBuilder Application Server Plug-in 1.1
PowerBuilder Application Server Plugin 1.0
SAP Sybase PowerDesigner 16.5 SP03
SAP Sybase PowerDesigner 16.5 SP02
PowerDesigner 16.5
PowerDesigner 16.1
PowerDesigner 16.0
Real-Time Data Services 4.5
Real Time Data Services 4.0
Real Time Data Services 3.5
Replication Agent 15.0
Replication Agent for DB2 UDB 15.0
SAP Replication Server 15.7.1 SP203
SAP Replication Server 15.7.1 SP202
SAP Replication Server 15.7.1 SP201
SAP Replication Server 15.7.1 SP200
SAP Replication Server 15.7.1 SP200 (Japanese)
SAP Replication Server 15.7.1 SP200 (Simplified Chinese)
Replication Server 15.7.1 SP110
Replication Server 15.7.1 SP100
Replication Server 15.7.1
Replication Server 15.7.1 (Japanese)
Replication Server 15.7.1 (Simplified Chinese)
Replication Server 15.7
Replication Server 15.6
Replication Server 15.5
Replication Server 15.2
Replication Server 15.1
Replication Server 15.0.1
Replication Server 15.0
SAP Replication Server Data Assurance Option 15.7.1 SP202
SAP Replication Server Data Assurance Option 15.7.1 SP200
Replication Server Data Assurance Option 15.7.1 SP110
Replication Server Data Assurance Option 15.7.1 SP100
Replication Server Data Assurance Option 15.7.1
Replication Server - Data Assurance Option 15.7.1 (Japanese)
Replication Server - Data Assurance Option 15.7.1 (Simplified Chinese)
Replication Server Data Assurance Option 15.7
SAP Replication Server, heterogeneous edition 15.7.1 SP200
Replication Server Heterogeneous Edition 15.7.1 SP100
Replication Server Heterogenous Edition 15.7.1
Replication Server Heterogenous Edition 15.7.1 (Japanese)
Replication Server Heterogenous Edition 15.7.1 (Simplified Chinese)
Replication Server Heterogenous Edition 15.6
Replication Server Heterogeneous Edition 15.2
Replication Server Messaging Edition 15.7.1 [SP100]
Replication Server Messaging Edition 15.7.1
Replication Server Messaging Edition 15.2
Replication Server Option for Oracle 15.7.1 ESD #2
SAP Replication Server Options 15.7.1 SP201
SAP Replication Server Options 15.7.1 SP200
Replication Server Options 15.7.1 SP120
Replication Server Options 15.7.1 SP100
Replication Server Options 15.7.1
Replication Server Options 15.7.1 (Japanese)
Replication Server Options 15.7.1 (Simplified Chinese)
Replication Server Options 15.6
Replication Server Options 15.5
Replication Server Options 15.2
Replication Server Options 15.1
Replication Server Options 15.0
Replication Server Real-Time Loading Edition 15.7.1 ESD #2
SAP Mobile Platform SDK 3.0 SP02
SAP Mobile Platform Server 3.0 SP02
SAP Mobile Platform SDK 3.0 and SP01
SAP Mobile Platform 2.3 SP04
SAP Mobile Platform 2.3 SP03
SAP Mobile Platform 2.3 SP02
SAP Mobile Platform 2.3
SAP Sybase RAP 5.0
SDK for SAP ASE 16.0
Software Developers Kit 15.7 SP127
Software Developer's Kit 15.7 SP121
Software Developer's Kit 15.7 SP110
Software Developer's Kit 15.7 SP100
Software Developer's Kit 15.7
Software Developer's Kit 15.5
Software Developer Kit 15.0
Software Developer Kit 12.5.1
SQL Anywhere 12.0.1
SQL Anywhere 12.0.0
SQL Anywhere 11.0.1
SQL Anywhere 11.0.0
SQL Anywhere 10.0.1
SQL Anywhere 10.0
Sybase Aleri Streaming Platform 3.1
Sybase Aleri Streaming Platform 3.2
Sybase Brand Mobiliser 1.3
Sybase Brand Mobiliser 1.2
Sybase Brand Mobiliser 1.1
Sybase CEP Option R4
SAP Control Center 3.3
Sybase Control Center 3.2.8 ESD2
Sybase Control Center 3.2.8 ESD1
Sybase Control Center 3.2.8
Sybase Control Center 3.2.7
Sybase Control Center 3.2.6
Sybase Control Center 3.2.5
Sybase Control Center 3.2.4
Sybase Control Center 3.2.3
Sybase Control Center 3.2.1
Sybase Control Center 3.2
Sybase Control Center 3.1.1
Sybase Control Center 3.1
Sybase Control Center 3.0.1
Sybase Control Center 3.0
Sybase ETL 4.9
Sybase ETL 4.9 (Simplified Chinese)
Sybase ETL 4.9 (Japanese)
Sybase ETL 4.8
Sybase ETL 4.8 - Simplified Chinese
Sybase ETL 4.8 - Japanese
SAP Sybase Event Stream Processor 5.1 SP04
SAP Sybase Event Stream Processor 5.1 SP03
SAP Sybase Event Stream Processor 5.1 SP02
Sybase Event Stream Processor 5.1 SP01
Sybase Event Stream Processor 5.1
Sybase Event Stream Processor 5.0
Sybase Event Stream Processor 5.0 (Japanese)
SAP Sybase IQ 16.0 SP04
SAP Sybase IQ 16.0 SP03
SAP Sybase IQ 16.0 SP03 (Japanese)
SAP Sybase IQ 16.0 SP03 (Simplified Chinese)
SAP Sybase IQ 16.0 SP2
SAP Sybase IQ 16.0 SP01
SAP Sybase IQ 16.0
Sybase IQ 15.4
Sybase IQ 15.4 (Japanese)
Sybase IQ 15.4 (Simplified Chinese)
Sybase IQ 15.3
Sybase IQ InfoPrimer 15.3
Sybase IQ 15.3 (Japanese)
Sybase IQ 15.3 (Simplified Chinese)
Sybase IQ 15.2
Sybase IQ 15.2 - (Japanese)
Sybase IQ 15.2 (Simplified Chinese)
Sybase IQ 15.1
Sybase IQ 15.1 (Japanese)
Sybase IQ 15.1 - Simplified Chinese
Sybase IQ 15.0
Sybase mBanking 365 3.0
Sybase mBanking 365 2.1
Sybase mBanking 365 2.0
Sybase Mobile Sales for SAP CRM 1.2.1
Sybase Mobile Sales for SAP CRM 1.2
Sybase Mobile Sales for SAP CRM 1.1
Sybase Mobile Sales for SAP CRM 1.0
Sybase Mobile Workflow for SAP Business Suite 1.2.1
Sybase Mobile Workflow for SAP Business Suite 1.2
Sybase Mobile Workflow for SAP Business Suite 1.1
Sybase Mobiliser Platform 5.1 SP03
Sybase Mobiliser Platform 5.1
Sybase Mobiliser Platform 5.0
Sybase SAP DOE Connector 2.1
Sybase SAP DOE Connector 2.0
Sybase Search 3.1
Sybase Unwired Platform 2.2 SP05
Sybase Unwired Platform 2.2 SP04
Sybase Unwired Platform 2.2 SP03
Sybase Unwired Platform 2.2
Sybase Unwired Platform 2.1 ESD #3
Sybase Unwired Platform 2.1 ESD #2
Sybase Unwired Platform 2.1 ESD #1
Sybase Unwired Platform 2.1
Sybase Unwired Platform 2.0 ESD #1
Sybase Unwired Platform 2.0
Sybase Unwired Platform 1.5.5
Sybase Unwired Platform 1.5.3
Sybase Unwired Platform 1.5.2
Sybase Unwired Platform 1.2.4
Sybase Unwired Platform 1.2.2
Sybase Unwired Platform 1.2.1
Sybase Unwired Platform 1.2
Sybase WorkSpace 2.5
Sybase WorkSpace 2.1.2
Sybase WorkSpace 2.1
Sybase WorkSpace 2.0.2
SyBooks 3.4
SyBooks 3.0.1
SySAM Documentation
SySAM Documentation - Japanese
SySAM Documentation - Simplified Chinese
SyBooks Online Infocenter Help