WebLogic Tuxedo Connector Programmer's Guide

Introduction to WebLogic Tuxedo Connector Programming

Guide to this Document

Developing WebLogic Tuxedo Connector Applications

Developing WebLogic Tuxedo Connector Clients

Developing WebLogic Tuxedo Connector Servers

WebLogic Tuxedo Connector Interoperability with Tuxedo CORBA objects

WebLogic Tuxedo Connector JATMI Primitives

WebLogic Tuxedo Connector TypedBuffers

Developing WebLogic Tuxedo Connector Client EJBs

Joining and Leaving Applications

Joining an Application

Leaving an Application

Basic Client Operation

Get a Tuxedo Object

Perform Message Buffering

Send and Receive Messages

Request/Response Communication

Using Synchronous Service Calls

Using Deferred Synchronous Service Calls

Using Asynchronous Calls

Conversational Communication

Enqueuing and Dequeuing Messages

Close a Connection to a Tuxedo Object

Example Client EJB

Developing WebLogic Tuxedo Connector Service EJBs

Basic Service EJB Operation

Access Service Information

Buffer Messages

Perform the Requested Service

Return Client Messages for Request/Response Communication

Use tpsend and tprecv for Conversational Communication

Example Service EJB

Using WebLogic Tuxedo Connector for RMI/IIOP and CORBA Interoperability

How to Develop WebLogic Tuxedo Connector Client Beans using the CORBA Java API

Using CosNaming Service

Example ToupperCorbaBean.java Code

Using FactoryFinder

WLEC to WebLogic Tuxedo Connector Migration

Example Code

How to Develop RMI/IIOP Applications for the WebLogic Tuxedo Connector

How to Modify Inbound RMI/IIOP Applications to use the WebLogic Tuxedo Connector

How to Develop Outbound RMI/IIOP Applications to use the WebLogic Tuxedo Connector

How to Modify the ejb-jar.xml File to Pass a FederationURL to EJBs

Assign env-entry-name

Assign env-entry-type

Assign env-entry-value

How to Modify EJBs to Use FederationURL to Access an Object

How to Use FederationURL Formats

Using corbaloc URL Format

Examples of corbaloc:tgiop

Examples using -ORBInitRef

Examples Using -ORBDefaultInitRef

Using the corbaname URL Format

Examples Using -ORBInitRef

How to Manage Transactions for Tuxedo CORBA Applications

WebLogic Tuxedo Connector JATMI Transactions

Global Transactions

JTA Transaction API

Types of JTA Interfaces

Transaction

TransactionManager

UserTransaction

JTA Transaction Primitives

Defining a Transaction

Starting a Transaction

Using TPNOTRAN

Terminating a Transaction

WebLogic Tuxedo Connector Transaction Rules

Example Transaction Code

WebLogic Tuxedo Connector JATMI Conversations

Overview of WebLogic Tuxedo Connector Conversational Communication

WebLogic Tuxedo Connector Conversation Characteristics

WebLogic Tuxedo Connector JATMI Conversation Primitives

Creating WebLogic Tuxedo Connector Conversational Clients and Servers

Creating Conversational Clients

Establishing a Connection to a Tuxedo Conversational Service

Example TuxedoConversationBean.java Code

Creating WebLogic Tuxedo Connector Conversational Servers

Sending and Receiving Messages

Sending Messages

Receiving Messages

Ending a Conversation

Tuxedo Application Originates Conversation

WebLogic Tuxedo Connector Application Originates Conversation

Ending Hierarchical Conversations

Executing a Disorderly Disconnect

Understanding Conversational Communication Events

WebLogic Tuxedo Connector Conversation Guidelines

Using FML with WebLogic Tuxedo Connector

Overview of FML

The WebLogic Tuxedo Connector FML API

FML Field Table Administration

Using the DynRdHdr Property for mkfldclass32 Class

Using TypedFML32 Constructors

Gaining TypedFML32 Performance Improvements

tBridge XML/FML32 Translation

FLAT

NO

FML32 Considerations

Using XmlFmlCnv Class for Manual XML to and From FML/FML32 Translation

MBSTRING Usage

Sending MBSTRING Data to a Tuxedo Domain

Receiving MBSTRING Data from a Tuxedo Domain

Using FML with WebLogic Tuxedo Connector

WebLogic Tuxedo Connector JATMI VIEWs

Overview of WebLogic Tuxedo Connector VIEW Buffers

How to Create a VIEW Description File

Example VIEW Description File

How to Use the viewj Compiler

How to Pass Information to and from a VIEW Buffer

How to Use VIEW Buffers in JATMI Applications

How to Get VIEW32 Data In and Out of FML32 Buffers

How to Create a Custom AppKey Plug-in

How to Create a Custom Plug-In

Example Custom Plug-in

Application Error Management

Testing for Application Errors

Exception Classes

Fatal Transaction Errors

WebLogic Tuxedo Connector Time-Out Conditions

Blocking vs. Transaction Time-out

Effect on commit()

Effect of TPNOTRAN

Guidelines for Tracking Application Events