This guide serves as a reference manual for:
System administrators setting up a distributed transaction processing (DTP) environment that includes one or more Adaptive Servers with distributed transaction management features, accessed by transactions from within a CICS, Encina, or TUXEDO transaction manager (TM) system.
Application programmers using Embedded SQL™ or Client-Library™ to access data on one or more Adaptive Servers.
This manual assumes the reader is familiar with:
The TM operating environment
Embedded SQL
Open Client™ Client-Library
Adaptive Server® administration
Use this guide to help configure your environment and code your application to access data stored on one or more Adaptive Servers from within a CICS, Encina, or TUXEDO TM.
Chapter 1, “Introduction” summarizes the steps necessary to fully integrate the DTM XA Interface into your environment.
Chapter 2, “The Sybase XA Environment” provides background information designed to help you place the Sybase XA environment into the larger context of distributed transaction processing and transaction management. It reviews the X/Open DTP model of distributed transaction processing and fits the Sybase DTM XA Interface into this model. In addition, it describes how the individual components of the Sybase® XA environment work together to allow your application to access Adaptive Server data from a TM.
Chapter 3, “Configuring the XA Environment” gives instructions for configuring your environment to fully integrate your application, Sybase DTM XA Interface, one or more Adaptive Servers, and your TM software.
Chapter 4, “Application Programming Guidelines” explains how to make your Embedded SQL or Client-Library application conform to certain coding constraints that the Sybase XA environment imposes.
The Installation Guide for your platform explains how to install Adaptive Server and the DTM XA Interface. It also describes how to install licenses for Adaptive Server features such as distributed transaction management.
To use this manual, you should also be familiar with the information described in the following manuals:
Using Adaptive Server Distributed Transaction Management Features
X/Open CAE Specification (December 1991) Distributed Transaction Processing: The XA Specification
Open Client Embedded SQL/COBOL Programmer’s Guide or Open Client Embedded SQL/C Programmer’s Guide
Open Client Embedded SQL Reference Manual
Open Client-Library/C Reference Manual
Open Client-Library/C Programmer’s Guide
System Administration Guide
Your CICS, Encina, or TUXEDO TM documentation set
Use the Sybase Technical Library CD and the Technical Library Product Manuals Web site to learn more about your product:
Technical Library CD contains product manuals and is included with your software. The DynaText browser (downloadable from Product Manuals) allows you to access technical information about your product in an easy-to-use format.
Refer to the Technical Library Installation Guide in your documentation package for instructions on installing and starting the Technical Library.
Technical Library Product Manuals Web site is an HTML version of the Technical Library CD that you can access using a standard Web browser. In addition to product manuals, you will find links to the Technical Documents Web site (formerly known as Tech Info Library), the Solved Cases page, and Sybase/Powersoft newsgroups.
To access the Technical Library Product Manuals Web site, go to Product Manuals.
Technical documentation at the Sybase Web site is updated frequently.
For the latest information on product certifications
Point your Web browser to Technical Documents.
Select Products from the navigation bar on the left.
Select a product name from the product list.
Select the Certification Report filter, specify a time frame, and click Go.
Click a Certification Report title to display the report.
For the latest information on EBFs and Updates
Point your Web browser to Technical Documents.
Select EBFs/Updates. Enter user name and password information, if prompted (for existing Web accounts) or create a new account (a free service).
Specify a time frame and click Go.
Select a product.
Click an EBF/Update title to display the report.
To create a personalized view of the Sybase Web
site (including support pages)
Set up a MySybase profile. MySybase is a free service that allows you to create a personalized view of Sybase Web pages.
Point your Web browser to Technical Documents
Click MySybase and create a MySybase profile.
Each Sybase installation that has purchased a support contract has one or more designated people who are authorized to contact Sybase Technical Support. If you cannot resolve a problem using the manuals or online help, please have the designated person contact Sybase Technical Support or the Sybase subsidiary in your area.
