Using XMLink
Contents
About This Document
What You Need to Know
Documentation Website
How to Print the Document
Documentation Conventions
Contact Us!
1. Overview
Java Compliance
What Oracle Tuxedo Features Are Supported
What Is In This Manual
2. Installing XMLink
Contents of the Installation Package
Hardware and Software Requirements
Installing XMLink on UNIX
Implementing File Protection
Determining File Location
How to Install from CD-ROM
Installing XMLink on Windows
How to Run the Setup Program
3. Configuring XMLink
Configuration Notes
Managed and Non-Managed Environments
Managed Environment Settings
Installing Resource Adapter Archives
Deploying in a Non-Managed Environment
Configuring the Environment
Setting XMLink Properties
Setting JVM Properties
Setting Properties on a Resource Adapter
Setting Properties on a Connection Factory
Sample Configuration
4. Using Java to Call Services
Getting an Oracle Tuxedo Connection
Example: Connecting with a Java Client
Understanding the ConnectionFactory Interface
Supplying Connection Parameters
Getting Information about XMLink
Calling getRecordFactory
Specifying Transaction Access
Managing Oracle Tuxedo Transactions
Calling Oracle Tuxedo Services
Understanding the Interaction Interface
Understanding the TuxInteractionSpec Interface
Working with Application Data
Understanding the RecordFactory Interface
Working with Record Objects
FMLRecord and FML32Record Objects
Sample: Getting FML Data
CArrayRecord and StringRecord Objects
Character Encoding Support
Example: Calling Services using Java
5. Using XML to Call Services
Inputting Data Using XML
Elements in the XML Input DTD
Agenda Element
Connection Element
Transaction and Servicecall Elements
Field Elements
Data Elements
Example: Using XML Input
Returning Data in XML
Elements in the XML Output DTD
Resultset Elements
Returndata Elements
Error Elements
Xactionmsg Elements
Examples: XML Return Data
Using an EJB to Input XML
A. Troubleshooting
Configuration Issues
Tuxedo Error Messages
Using the TuxedoException Class
Using the TuxedoReturnCodeWarning Class
Using XMLink with Tuxedo 6.5
B. New Features in XMLink
XMLink 3.1
XMLink 3.0
Changes to Connection Factory Properties
No Default Setting for XMLink.tconn
Improved XML support
XMLink 2.6
Embedded FML
Character Encoding Support
XMLink 2.1
XMLink 2.0
JNDI Lookup
Installation Issues
Setting Properties for Connections and Connection Factories
Deploying in a Non-managed Environment
Index
