Preface


The iPlanet Application Server Enterprise Connector for Tuxedo Developer's Guide describes how to develop Java 2 Enterprise Edition (J2EE) compliant applications that access the BEA Tuxedo® services.

This guide assumes some understanding of:

• iPlanet Application Server administration

• iPlanet Application Server programming concepts

• The Internet and World Wide Web

• System management knowledge of BEA Tuxedo

• Familiarity with BEA Tuxedo programming

• Java 2 Enterprise Edition APIs (EJB, JSP, and Servlets)

• iPlanet Application Server Enterprise Connector for Tuxedo configuration concepts

How This Guide Is Organized

---

Chapter 1 "Introduction" describes Unified Integration Framework (UIF) and iPlanet Application Server Enterprise Connector for Tuxedo architecture and tools.

Chapter 2 "Programming for Tuxedo" describes how to develop J2EE applications which access Tuxedo services using the iPlanet Application Server Enterprise Connector for Tuxedo.

Documentation Conventions

---

File and directory paths are provided in Windows format with backslashes separating directory names. For Unix versions, the directory paths are the same, except slashes should be substituted in place of backslashes.

This guide uses URLs of the form http://server.domain/path/file.html

Where:

• server is the name of the server where you are running your application.

• domain is your Internet domain name.

• path is the directory structure on the server.

• file is an individual filename.

This guide uses the following font conventions:

• The monospace font is used for sample code and code listings, API and language elements (such as function names and class names), file names, pathnames, directory names, and HTML tags.

• Italic type is used for book titles, emphasis, variables and placeholders, and words used in the literal sense.

User Roles

---

This section describes the various user roles and their tasks. People with a variety of skills are involved with the setup of iPlanet Application Server Enterprise Connector for Tuxedo. Some of these users are listed below:

System Administrator	This person is responsible for the Tuxedo Enterprise Connector installation.
Systems or Business Analyst	This person uses the Tuxedo Management Console to configure the Tuxedo Enterprise Connector and import Tuxedo data types and services into UIF Repository.
Applications Programmer	This person who writes Servlets, JavaServer Pages (JSPs) and Enterprise Java Beans (EJBs) that call the UIF API. This person also uses the UIF Repository Browser to determine the available Function Objects (Tuxedo Services).
Tuxedo Programmer	This person develops Tuxedo services using the Application to Transaction Manager Interface (ATMI) interface.

Online Guides

---

You can find the iPlanet Application Server Enterprise Connector for Tuxedo Developer's Guide online in PDF and HTML formats at:

http://docs.iplanet.com/docs/manuals/ias.html

Related Information

---

In addition to this Developer's Guide, the Tuxedo Enterprise Connector comes with a Administrator's Guide. The Administrator's guide explains how to install and configure the Tuxedo Enterprise Connector.

The installer copies these publications to ias/APPS/docs/tux subdirectory of the root installation directory of the iPlanet Application Server.

Also refer to the iPlanet Unified Integration Framework Developer's Guide under the ias/APPS/docs/bsp subdirectory of the root installation of iPlanet Application Server for detailed information about the UIF API and Repository Browser.

In addition to these guides, there is additional information for administrators, users and developers. Use the following URL to view the related documentation:

http://docs.iplanet.com/docs/manuals/ias.html

The following lists the additional documents:

• iPlanet Application Server Release Notes

• iPlanet Application Server Installation Guide

• iPlanet Application Server Overview Guide

• iPlanet Administration and Deployment Guide

• iPlanet Java Programmer's Guide

• iPlanet Application Builder Release Notes

• iPlanet Application Builder Installation Guide

• iPlanet Application Builder User's Guide

Third Party Publications

---

The following BEA publications may be useful:

• BEA Tuxedo : Administrating the BEA Tuxedo System

• BEA Tuxedo : Application Development Guide

• BEA Tuxedo : Programmer's Guide

• BEA Tuxedo : Workstation Guide

• BEA Tuxedo : Reference Manual

For more information about Tuxedo technology, refer to the following books:

• Building Client/Server Applications Using Tuxedo - Carl L. Hall

• The TUXEDO System - Andrade, Carges, Dwyer, Felts