Using XMLink

About This Document

This document explains XMLink and describes how to use XMLink to call services in an Oracle Tuxedo application.

This document covers the following topics:

What You Need to Know

This document is intended for application developers interested in building Java applications that access services in an Oracle Tuxedo application. It assumes a familiarity with Oracle Tuxedo applications and Java programming.

Even though XMLink works with any J2C 1.5-compliant application server, this document primarily describes how to use XMLink with IBM WebSphere application server. For any information on other application servers, check the Release Notes area of the XMLink documentation site at

Documentation Website

The XMLink documentation website includes the Using XMLink manual in HTML and PDF formats and the Java API documentation in Javadoc format. The website also enables you to search the HTML files for both the manual and the Java API.

This documentation is also distributed with the product either in the docs directory or on the product CD.

XMLink product documentation is available on the Prolifics corporate website at

How to Print the Document

You can print a copy of this document from a web browser, one file at a time, by using the FilePrint option on your web browser.

A PDF version of this document is available from the documentation website. You can open the PDF in Adobe Acrobat Reader and print the entire document (or a portion of it) in book format.

If you do not have the Adobe Acrobat Reader, you can get it for free from the Adobe website at

Documentation Conventions

The following documentation conventions are used throughout this document.

Convention Item


Indicates that you must press two or more keys simultaneously. Initial capitalization indicates a physical key.


Indicates emphasis or book titles.

boldface text

Indicates terms defined in the glossary.

monospace text

Indicates code samples, commands and their options, directories, and file names and their extensions. Monospace text also indicates text that you must enter from the keyboard.


chmod u+w *



monospace italic text

Identifies variables in code representing the information you supply.


String expr


Indicates environment variables, logical operators, SQL keywords, mnemonics, or Prolifics constants.




{ }

Indicates a set of choices in a syntax line. One of the items should be selected. The braces themselves should never be typed.


Separates mutually exclusive choices in a syntax line. The symbol itself should never be typed.

[ ]

Indicates optional items in a syntax line. The brackets themselves should never be typed.


java com.prolifics.tconn.TConnTool [-list]


Indicates one of the following in a command line:


Indicates the omission of items from a code example or from a syntax line. The vertical ellipsis itself should never be typed.

Contact Us!

Your feedback on the documentation is important to us. Send us e-mail at if you have questions or comments. In your e-mail message, please indicate that you are using the documentation for XMLink 3.0.

If you have any questions about this version of XMLink, or if you have problems installing and running XMLink, contact Customer Support via:

When contacting Customer Support, be prepared to provide the following information: