Contents

Title and Copyright Information

Preface

• Documentation Accessibility
• Conventions

1 Introduction to Oracle WebLogic Tuxedo Connector Programming

• Guide to this Document
• Developing Oracle WebLogic Tuxedo Connector Applications
  • Developing Oracle WebLogic Tuxedo Connector Clients
  • Developing Oracle WebLogic Tuxedo Connector Servers
  • Oracle WebLogic Tuxedo Connector Interoperability with Oracle Tuxedo CORBA objects
• Oracle WebLogic Tuxedo Connector JATMI Primitives
• Oracle WebLogic Tuxedo Connector TypedBuffers

2 Developing Oracle WebLogic Tuxedo Connector Client EJBs

• Joining and Leaving Applications
  • Joining an Application
  • Leaving an Application
• Basic Client Operation
  • Get an Oracle Tuxedo Object
  • Perform Message Buffering
  • Send and Receive Messages
    • Request/Response Communication
    • Conversational Communication
    • Enqueuing and Dequeuing Messages
  • Close a Connection to an Oracle Tuxedo Object
• Example Client EJB

3 Developing Oracle 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

4 Using Oracle WebLogic Tuxedo Connector for RMI/IIOP and CORBA Interoperability

• How to Develop Oracle WebLogic Tuxedo Connector Client Beans using the CORBA Java API
  • Using CosNaming Service
    • Example ToupperCorbaBean.java Code
  • Using FactoryFinder
    • WLEC to Oracle WebLogic Tuxedo Connector Migration
    • Example Code
• How to Develop RMI/IIOP Applications for the Oracle WebLogic Tuxedo Connector
  • How to Modify Inbound RMI/IIOP Applications to use the Oracle WebLogic Tuxedo Connector
  • How to Develop Outbound RMI/IIOP Applications to use the Oracle WebLogic Tuxedo Connector
    • How to Modify the ejb-jar.xml File to Pass a FederationURL to EJBs
    • 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 Oracle Tuxedo CORBA Applications

5 Oracle 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
• Oracle WebLogic Tuxedo Connector Transaction Rules
• Example Transaction Code

6 Oracle WebLogic Tuxedo Connector JATMI Conversations

• Overview of Oracle WebLogic Tuxedo Connector Conversational Communication
• Oracle WebLogic Tuxedo Connector Conversation Characteristics
• Oracle WebLogic Tuxedo Connector JATMI Conversation Primitives
• Creating Oracle WebLogic Tuxedo Connector Conversational Clients and Servers
  • Creating Conversational Clients
    • Establishing a Connection to an Oracle Tuxedo Conversational Service
    • Example TuxedoConversationBean.java Code
  • Creating Oracle WebLogic Tuxedo Connector Conversational Servers
• Sending and Receiving Messages
  • Sending Messages
  • Receiving Messages
• Ending a Conversation
  • Oracle Tuxedo Application Originates Conversation
  • Oracle WebLogic Tuxedo Connector Application Originates Conversation
  • Ending Hierarchical Conversations
• Executing a Disorderly Disconnect
• Understanding Conversational Communication Events
• Oracle WebLogic Tuxedo Connector Conversation Guidelines

7 Using FML with Oracle WebLogic Tuxedo Connector

• Overview of FML
• The Oracle 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 the XmlFmlCnv Class for XML to and From FML/FML32 Translation
  • Limitations of XmlFmlCnv Class
• MBSTRING Usage
  • Sending MBSTRING Data to an Oracle Tuxedo Domain
  • Receiving MBSTRING Data from an Oracle Tuxedo Domain
  • Using FML with Oracle WebLogic Tuxedo Connector

8 Oracle WebLogic Tuxedo Connector JATMI VIEWs

• Overview of Oracle 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
• Using the XmlViewCnv Class for XML to and From View/View(32) Translation

9 How to Create a Custom AppKey Plug-in

• How to Create a Custom Plug-In
• Example Custom Plug-in

10 Application Error Management

• Testing for Application Errors
  • Exception Classes
  • Fatal Transaction Errors
• Oracle WebLogic Tuxedo Connector Time-Out Conditions
  • Blocking vs. Transaction Time-out
  • Effect on commit()
  • Effect of TPNOTRAN
• Guidelines for Tracking Application Events