Contents

Title and Copyright Information

List of Tables

Send Us Your Comments

Preface

Audience

Organization

Related Documentation

Conventions

Documentation Accessibility

1 Overview of the Oracle Application Server Integration Adapter for Tuxedo

Overview of Application Integration

Overview of Tuxedo and Oracle Application Server Integration Adapter for Tuxedo

Tuxedo

Architecture of the Oracle Application Server Integration Adapter for Tuxedo

Inbound Interactions

Integrating Oracle Application Server ProcessConnect with the Adapter for Tuxedo

The Modeling Phase

Runtime

Modeling the Tuxedo Adapter Using Oracle Studio

The Configuration Perspective

The Metadata Perspective

The Metadata Import Perspective

The Runtime Manager Perspective

2 Installing the Oracle Application Server Integration Adapter for Tuxedo

Before You Begin

Determining the UNIX Hardware and Software Requirements

Hardware Requirements

Software Requirements

Determining the Hardware and Software Requirements for Windows

Hardware Requirements

Software Requirements

Installing Oracle Connect for Tuxedo on a UNIX Platform

Preinstallation Instructions

Installing the Kit

Installation Instructions

Postinstallation Instructions

Setting Up the Oracle Connect for Tuxedo Environment

Setting the Tuxedo Environment for Oracle Connect for Tuxedo

Setting the Oracle Connect for Tuxedo Script

Starting the Oracle Connect for Tuxedo Daemon

Installing Oracle Connect for Tuxedo on a Windows Platform

Installing Oracle Studio

Installing Oracle Studio from the CD-ROM

Configuring Oracle Connect for Tuxedo

Task: Setting Up the Tuxedo Workstation Machine

Securing Access to Oracle Connect for Tuxedo

Setting Password Access to Oracle Studio

Task: Setting Up a Master Password to Access Oracle Studio

Specifying Users with Administrative Rights

Task: Setting Administrative Rights to a Machine

Setting Up Runtime User Access to the Tuxedo Workstation Machine

3 Modeling Interactions for Oracle Application Server Integration Adapter for Tuxedo

Setting Up Oracle Connect for Tuxedo

Task: Setting Up the Backend Adapter

Generating Outbound Interactions

Task 1: Defining an Import Procedure

Task 2: Generating Outbound Interactions

Generating Outbound Interactions Using a Jolt File

Generating Outbound Interactions Using View Files

Generating Inbound Interactions

Task 1: Defining an Import Procedure

Task 2: Generating Inbound Interactions

4 Using Interactions in a Business Process

Adding the Tuxedo Adapter in Oracle Application Server ProcessConnect

Setting Up the Delivery Channel

Task: Setting Up the Delivery Channel

Modifying an Adapter In Oracle Studio

Comparing a ProcessConnect XSD to an Oracle Connect Record Schema

5 Oracle Application Server Integration Adapter for Tuxedo Features and Restrictions

Tuxedo Message Buffer Support

Sending Inbound Interactions Using a Tuxedo Service

Connection APIs

The Connect Function

The Disconnect Function

The Reauthenticate Function

The Clean Connection Function

Transaction APIs

The Set Autocommit Function

The Transaction Commit Function

The Transaction Rollback Function

The Execute Function

The Get Adapter Schema Function

The Get Event Function

The Ping Function

The Get Error Function

High Availability with Oracle Connect

Known Restrictions

Data Handling

Datatype Handling

User-Defined Datatypes

6 Troubleshooting the Oracle Application Server Integration Adapter for Tuxedo

Design-Time Troubleshooting

Specifying the Wrong Adapter Name

Specifying the Wrong Workspace Name

Specifying the Wrong Machine

Specifying the Wrong Port Number

When the Connection with the Tuxedo Workstation Machine Is Down

Troubleshooting the Daemon

Starting the Daemon

Task: Starting the Daemon

Shutting Down the Daemon

Monitoring the Daemon During Runtime

Daemon (Machine) Options

Workspace Options

Server Options

Daemon Logs

The Daemon Log Monitor

The Workspace Log Monitor

The Server Log Monitor

Resolving Communication Errors

Resolving Specific Errors

7 Configuring the Working Environment

Configuring the Daemon for High Availability

Task: Adding a New Daemon Workspace Configuration

Task: Editing the Workspace

Task: Configuring the Server Mode

Configuring a Binding Environment

Task: Setting a Binding Environment

comm Category

debug Category

miscellaneous Category

odbc Category

oledb Category

optimizer Category

queryProcessor Category

transactions Category

tuning Category

A The Oracle Connect Tuxedo Interaction Metadata Definitions

Interaction Metadata for the Adapter

General Tab

Interaction Tab

Schema General Tab

Schema Record Tab

Source Tab

B Datatype Support

Datatype Mapping

C Daemon Configuration Settings

Daemon Control

Daemon Logging

Daemon Security

Workspaces

WS Info.

WS Server

WS Logging

WS Security

D National Language Settings

Defining the Language and Codepage

Index