Programmer's Guide

Jaguar CTS

Subject

This book contains information about how to build distributed applications that run on Jaguar CTS™.

Audience

The Jaguar CTS Programmer's Guide is written for application developers who are familiar with their chosen programming languages, specifically C, C++ or Java, C++, C, or an ActiveX scripting language.

Though you do not need to know all of these languages to create Jaguar components or clients, the chapters that pertain to each language assume a basic familiarity with that language.

How to Use This Book

For an overview of Jaguar features, design concepts, and the application development process, see these chapters:

Chapter 1, "Introducing Jaguar CTS" contains overview information about building Jaguar applications, clients, and components.
Chapter 2, "Creating Component-Based Applications" provides a level overview of a typical development process.
Chapter 3, "Understanding Transactions and Component Lifecycles" describes how Jaguar manages multi-component transactions and component lifecycles.

For general information on developing components for Jaguar, see these chapters:

Chapter 4, "Managing Applications and Packages in Jaguar Manager" describes how to create applications and packages in Jaguar Manager. These items are required vehicles for component deployment to a Jaguar server.
Chapter 5, "Defining Components" describes how to define packages and components in Jaguar Manager and configure component properties.
Chapter 6, "Defining Component Interfaces" describes how to create, view, and edit component interfaces in Jaguar Manager.

For information on developing Enterprise Java Beans (EJB) components, see these chapters:

Chapter 7, "Enterprise JavaBeans Overview" introduces the EJB component model.
Chapter 8, "Creating Enterprise JavaBean Components" describes how to create Enterprise JavaBean components.
Chapter 9, "Creating Enterprise JavaBean Clients" describes how to implement a client that uses the EJB client interfaces to call Jaguar component methods.
Chapter 10, "Jaguar EJB Interoperability" describes how to call non-EJB components from EJB clients or components, and how to call EJB components from non-EJB clients.
Chapter 11, "Creating Application Clients" describes how to create and deploy EJB application clients.

For information on developing components using the Java/CORBA model, see these chapters:

Chapter 12, "Creating CORBA-Java Components" contains information about building CORBA-Java components.
Chapter 13, "Creating CORBA-Compatible Java Clients" describes how to implement a client that uses Jaguar's CORBA-compatible Object Request Broker (ORB) to call Jaguar component methods. This chapter is also useful to Java developers that use another vendor's Java ORB to interact with Jaguar components.
Chapter 14, "Using SSL and Proxy Connections in Java Clients" describes how to create secure connections from a Java client application.

For information on developing components using the CORBA/C++ model, see these chapters:

Chapter 15, "CORBA C++ Overview" describes Jaguar's C++ support and explains how Jaguar maps CORBA IDL datatypes to C++ datatypes.
Chapter 16, "Creating CORBA C++ Components" contains information about building C++ components.
Chapter 17, "Creating CORBA C++ Clients" describes how to develop C++ clients that connect to Jaguar.

For information on developing ActiveX components, see these chapters:

Chapter 18, "Jaguar ActiveX Overview" describes Jaguar's ActiveX support, including how Jaguar maps CORBA IDL datatypes to ActiveX datatypes.
Chapter 19, "Creating ActiveX Components" contains information about building ActiveX components.
Chapter 20, "Creating ActiveX Clients" describes how to develop clients that connect to Jaguar using the Jaguar ActiveX client proxy server.
Chapter 21, "Using SSL in ActiveX Clients" describes how to create secure connections from an ActiveX client application.

For information on developing, configuring, and running Web applications, servlets, and Java Server Page, see these chapters:

Chapter 22, "Creating Web Applications" describes how to define and configure Web applications.
Chapter 23, "Creating Java Servlets" describes how to create and run Java servlets in Jaguar.
Chapter 24, "JavaServer Pages" describes how to create and run Java ServerPages in Jaguar.
Chapter 25, "Configuring Web Application Security" describes Jaguar's Web security model, and how to implement your own Web security policy.
Chapter 26, "Using HTTP and HTTPS Connections in Java" describes how to create Java clients that connect to Jaguar or any other Web server using the HTTP and HTTPS protocols.

For information on advanced component features, see these chapters:

Chapter 27, "Sending Result Sets" describes how to send result sets from a method coded in C, C++, or Java.
Chapter 28, "Using Connection Management" describes how to access connection caches from a method coded in C, C++, or Java.
Chapter 29, "Managing Persistent Component State" describes how to create CORBA or EJB components that store state information in a remote database.
Chapter 30, "Creating JavaMail" describes how to use the JavaMail API to access an Internet mail server from Java components or servlets.
Chapter 31, "Using the Message Service" describes how to use Jaguar's asynchronous messaging service to implement event- or message-driven application logic in clients and components.
Chapter 32, "Using the Thread Manager" describes how to create threads to perform asynchronous processing in Jaguar components.
Chapter 33, "Creating Service Components" describes how to create components that run as Jaguar services.
Chapter 34, "Creating and Using Jaguar Pseudocomponents" describes Jaguar's C++ and Java pseudocomponent support.

If you have developed applications with Sybase Open Server™ or previous Jaguar versions, you may be interested in these features explained in the Appendixes:

Appendix A, "Executing Methods As Stored Procedures" contains reference pages for invoking Jaguar methods from any front-end tool that can execute Sybase® stored procedures.
Appendix B, "Open Server Migration To Jaguar" explains how to adapt existing Open Server applications to run in Jaguar.
Appendix C, "Creating Jaguar 1.1 Java Clients" describes how to program Java clients that use the interface that was defined in Jaguar version 1.1.
Appendix D, "Creating C Components" contains information about building C components.

Finally, for information on generating stubs and skeletons with the command-line IDL compiler, see Appendix E, "Using the Command Line IDL Compiler".

Related Documents

Jaguar CTS Getting Started for your platform contains tutorials and explains how to:

Start Jaguar server and Sybase Central
Create your first Jaguar components and client applications

The Jaguar CTS System Administration Guide explains how to:

Configure advanced server features such as using a different Java Virtual Machine or an OTS/XA transaction coordinator
Configure SSL certificate-based security for client connections
Define connection caches
Create clusters of Jaguar servers to host load-balanced and highly available components

The Jaguar CTS API Reference contains reference pages for Jaguar's Java classes, ActiveX interfaces, and C routines. This document is available in HTML format. (See index.html in the html/docs subdirectory of your Jaguar installation.)

For UNIX platforms, the Jaguar CTS Installation Guide and Release Notes contains installation instructions and late-breaking release information.

For Windows NT, Enterprise Application Server Installation Guide for Windows contains installation instructions and the file readme.htm on the Enterprise Application Server CD contains late-breaking release information for Jaguar CTS on Windows NT.

If you have purchased Enterprise Application Studio, Building Internet and Enterprise Applications describes how to use Jaguar with the other tools in the Studio to create distributed applications.

The Enterprise Application Server Feature Guide explains how to use Jaguar with other Enterprise Application Server products such as:

PowerDynamo™ for dynamic, data-driven Web page creation.
Application Integrator for CICS to allow Jaguar components to execute CICS programs on a mainframe.
Application Integrator for Stored Procedures to quickly integrate database stored procedures into component-based applications.
Adaptive Server® Anywhere, a full featured, easy to use, transactional database management system.

The Enterprise Application Server Web page provides whitepapers and other product information. See the following URL:

http://www.sybase.com/products/easerver/

Conventions

Commands are shown in Arial font:

javac

Variables are shown in italics:

CompName

Program text is shown in a monospace font:

package Sample.StockTrade;

If You Need Help

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.