Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Introduction

• OracleAS Adapters for Tuxedo Overview
  • Adapter for Tuxedo
  • Adapter for Tuxedo/Q
  • Adapter for Tuxedo Gateway
    • Buffer Types
    • Return Codes
• OracleAS Adapters for Tuxedo Architecture
  • Tuxedo Adapter for Inbound Architecture
    • The Flow from Oracle Application Server to the Legacy Application and Back
  • Tuxedo Gateway Adapter for Synchronous Inbound Architecture
    • Tuxedo Gateway Adapter Components

2 Installing OracleAS Adapters for Tuxedo

• Preinstallation Tasks
  • UNIX Hardware and Software Requirements
    • Hardware Requirements
    • Software Requirements
  • Windows Hardware and Software Requirements
    • Hardware Requirements
    • Software Requirements
• Before you Begin
  • Tuxedo Versions
  • Supported Platforms
• Installing Oracle Connect on a UNIX Platform
  • Preinstallation Tasks
  • Installing Oracle Connect
  • Installation Tasks
  • Post Installation Tasks
    • Configuring the Oracle Connect Environment
    • Configuring the Tuxedo Environment for Oracle Connect
    • Configuring the Oracle Connect Script
    • Starting the Oracle Connect Daemon
• Installing Oracle Connect on a Windows Platform
• Installing Oracle Studio
  • Oracle Studio Requirements
  • Installing Oracle Studio on Windows
  • Installing Oracle Studio on Linux
    • Installing Oracle Studio with the Wizard (SH installation)
    • Installing with a Silent Installation (RPM)

3 Configuring OracleAS Adapters for Tuxedo

• Configuring Oracle Connect Overview
• Configuring OracleAS Adapters for Tuxedo in Oracle Studio
• Securing Access to Oracle Connect
  • Setting Password Access to Oracle Studio
  • Specifying Users with Administrative Rights
  • Configuring Run-Time User Access to OracleAS Adapter for Tuxedo
• Setting up the Tuxedo OracleAS Adapter
  • Before You Begin...
  • Modeling Interactions for the Tuxedo OracleAS Adapter
    • Configuring a Tuxedo OracleAS Adapter
    • Starting Outbound Interactions Metadata Import
    • Getting a JOLT Input File for Tuxedo Adapter
    • Applying Filters for Tuxedo Adapter (JOLT)
    • Generating Interactions (JOLT)
    • Configuring Tuxedo Records for Tuxedo Adapter
    • Importing the Metadata Definitions for Tuxedo Adapter
    • Getting an FML or VIEW Import File for Tuxedo Adapter
    • Adding FML Records for Tuxedo Adapter (FML and View)
    • Getting Tuxedo Records for Tuxedo Adapter (FML and View Files)
    • Generating Interactions for Tuxedo Adapter (FML and View Files)
    • Starting Interactions Metadata Import
• Setting up the Tuxedo Queue OracleAS Adapter
  • Modeling Interactions for the Tuxedo Queue OracleAS Adapter
    • Configuring the Tuxedo Queue Adapter
    • Generating Inbound Interactions
    • Defining the Tuxedo Queue Unstructured Records
• Setting up the Tuxedo Gateway OracleAS Adapter
  • Configure the Tuxedo Gateway as a Regular Adapter
    • Configuring the Tuxedo Gateway Adapter in Oracle Studio
    • Setting Properties for the Tuxedo Gateway Adapter
    • Starting a Metadata Import for Tuxedo Gateway Adapter
    • Getting a JOLT Input File for Tuxedo Gateway Adapter
    • Applying Filters for Tuxedo Gateway Adapter (JOLT)
    • Generating Inbound Synchronous Interactions for Tuxedo Gateway Adapter (JOLT)
    • Configuring Tuxedo Records for Tuxedo Gateway Adapter
    • Importing the Metadata Definitions for Tuxedo Gateway Adapter
    • Getting an FML or VIEW Import File for Tuxedo Gateway Adapter
    • Adding FML Records for Tuxedo Gateway Adapter (FML and View)
    • Getting Tuxedo Records for Tuxedo Gateway Adapter (FML and View Files)
    • Generating Inbound Synchronous Interactions for Tuxedo Gateway Adapter (FML and View Files)
  • Configure a Non-Transactional Tuxedo Gateway as a Tuxedo Server
  • Configure a Transactional Tuxedo Gateway as a Tuxedo Group
  • Booting the Tuxedo Gateway Transaction Group
• Adapter Schema for the Tuxedo Gateway Adapter

4 BPEL Process Manager Examples

• Getting Started
• Deploy a BPEL Inbound Process
  • Beginning Tasks
  • Design-Time Configuration
    • Create a BPEL Project for a BPEL Inbound Process
    • Design the BPEL Inbound Process
    • Create the Connection
    • Deploy the BPEL Inbound Process
  • Runtime Configuration
    • Triggering the Event using the XML Utility
• Deploy a BPEL Outbound Process
  • Beginning Tasks
  • Design-Time Configuration
    • Before You Begin
    • Create a BPEL Project for a BPEL Outbound Process
    • Create a File Adapter to Read the String
    • Design a BPEL Outbound Process to Read the String
    • Create a Partner Link to the Tuxedo Adapter
    • Edit the Invoke_1 Activity
    • Edit the Assign_1 Activity
    • Create a Process to Write the Upper-Case Letter String
  • Runtime Configuration

5 Configuring an OracleAS Adapter for Tuxedo

• Creating Outbound Interactions with the OracleAS Adapter for Tuxedo
  • Create the toUpper Interaction
    • Prepare the System
    • Set up Machine Access to Oracle Connect
    • Add a Tuxedo Adapter
    • Import the Metadata
• Creating Inbound Interactions with the Tuxedo Queue Adapter
  • Create the DEQUEUE Event Queue
    • Prepare the System
    • Set up Machine Access to Oracle Connect
    • Add a Tuxedo Queue Adapter
    • Import the Metadata
• Creating Inbound Interactions with the Tuxedo Gateway Adapter
  • Create the DEQUEUE Interaction
    • Prepare the System
    • Set up Machine Access to Oracle Connect
    • Add a Tuxedo Gateway Adapter
    • Import the Metadata

6 Integrating OracleAS Adapters for Tuxedo with OC4J

• Overview of OC4J Functionality
• Integrating the Tuxedo Adapter for Outbound
  • Configuring the Tuxedo Adapter for Outbound
  • Using the CCI API to Develop Applications
• Integrating the Tuxedo Queue Inbound Adapter
  • Configuring the Tuxedo Queue Inbound Adapter
  • Using the CCI API to Develop Message Endpoint Applications
• Integrating the J2CA Tuxedo Gateway Synchronous Inbound Adapter
  • Configuring the J2CA 1.5 Tuxedo Gateway Synchronous Inbound Adapter

7 Integrating OracleAS Adapters for Tuxedowith Oracle BPEL Process Manager

• Overview of Oracle BPEL Process Manager Integration
• Configuring the Oracle BPEL Process Manager
  • Setting up the Connection to the Oracle Connect Server Metadata
  • Checking Metadata Availability Using Oracle JDeveloper
  • Selecting a WDSL for a Legacy Adapter Partner Link
  • Configuring Outbound WSDL
  • Configuring Inbound WSDL
• Configuring the Transactional Gateway Process
  • Configure the BPEL Transactional Gateway Process using JDeveloper
  • Configure the Resource Adapter Connection Factory
  • Configure the BPEL Transactional Gateway Wrapper Message Driven Bean

8 Troubleshooting OracleAS Adapter for Tuxedo

• Troubleshooting the Daemon
  • Starting the Daemon
    • Task: Starting the Oracle Connect Daemon
  • Shutting Down the Oracle Connect Daemon
  • Monitoring the Daemon During RunTime
    • Daemon (Computer) 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

9 Advanced Features of OracleAS Adapter for Tuxedo

• Configuring the Daemon for High Availability
  • Adding a New Daemon Workspace Configuration
  • Editing the Workspace
  • Configuring the Server Mode
• Configuring a Binding Environment
  • Debug
  • General
  • Language
  • Modeling
  • ODBC
  • OLEDB
  • Optimizer
  • Query Processor
  • Parallel Processing
  • Transactions
  • Tuning
  • XML
• Migration Considerations
• Security Considerations
  • Setting Design Time Security
  • Setting Run-Time Security
    • Encrypting Network Communications
• Transaction Support

A Advanced Tuning of the Metadata

• Editing Adapter Interactions
  • Adapter Metadata General Properties
  • Adapter Metadata Interactions
    • Adapter Metadata Interactions for the Tuxedo and Tuxedo Queue Adapters
    • Adapter Metadata Interactions for the Tuxedo Gateway Adapter
  • Adapter Metadata Schema Records
  • Adapter Metadata XML

B OracleAS Adapters for Tuxedo Message Buffer Support and Data Type Support

• OracleAS Adapters for Tuxedo Message Buffer Support
  • User-Defined Message Buffers
• Data Type Support
  • Data Type Mapping
  • Data Type Handling
  • Header Record Structure

C Advanced Tuning of the Daemon

• Control
• Logging
• Security
• Workspaces
  • General
  • Server Mode
  • Security

D Globalization Settings

• Defining the Language and Codepage

E Editing XML Files in Oracle Studio

• Preparing to Edit XML Files in Oracle Studio
• Making Changes to the XML File
  • Remove Objects
  • Add DTD Information
  • Edit Namespaces
  • Add Elements and Attributes
  • Replace an Element

Index