Preface

BEA eLink Adapter for XML (hereafter referred to as eLink Adapter) provides a way for TUXEDO applications to convert data from Field Markup Language (FML) format to Extensible Markup Language (XML) format.

Purpose of This Document

This guide describes the eLink Adapter component and gives instructions for using the tool for data format conversion. It contains instructions for installing and using the eLink Adapter component and explains how this component fits into the BEA TUXEDO environment.

Who Should Read This Document

This guide is intended for system administrators who configure and administer the eLink Adapter as well as programmers who write applications that use FML and XML data. This guide assumes knowledge of BEA TUXEDO, FML, and XML. This guide also assumes knowledge of the C programming language.

How This Document Is Organized

The BEA eLink Adapter for XML User Guide is organized as follows:

• BEA eLink Adapter for XML Overview introduces the eLink Adapter component and explains how eLink Adapter fits into the BEA TUXEDO environment.

• Installing the eLink Adapter for XML explains how to install the eLink Adapter component.

• Configuring the eLink Adapter for XML provides information for configuring the eLink Adapter to execute conversion services.

• Running Sample Applications provides information about how to build, configure and execute the sample applications.

• Error and Informational Messages describes error and informational messages as well as actions to resolve the errors.

How to Use This Document

The BEA eLink Adapter for XML User Guide is designed as a view-only and print-on-demand document in PDF format and is available on the product CD.

Document Conventions

The following documentation conventions are used throughout this document:

Item	Examples
Variable names	Variable names represent information you must supply or output information that can change; they are intended to be replaced by actual names. Variable names are displayed in italics and can include hyphens but not underscores.The following are examples of variable names in text: error-file-name The when-return value... In error codes, variables are enclosed in open and closed angle brackets. <fieldname>
User input and screen output	For screen displays and other examples of input and output, user input appears as in the first of the following lines; system output appears as in the second through fourth lines: dir c:\accounting\data Volume in drive C is WIN_NT_1 Volume Serial Number is 1234-5678 Directory of C:\BEADIR\DATA
Syntax	Code samples can include the following elements: Variable names can include hyphens but not underscores (e.g., error-file-name) Optional items are enclosed in square brackets: [ ]. If you include an optional item, do not code the square brackets. A required element for which alternatives exist is enclosed in braces {}. The alternatives are separated by the pipe (vertical bar) character: |. You must include only one of the alternatives for that element. Do not code the braces or pipe character. An ellipsis ( ... ) indicates that the preceding element can be repeated as necessary.
Omitted code	An ellipsis ( ... ) is used in examples to indicate that code that is not pertinent to the discussion is omitted. The ellipsis can be horizontal or vertical.
Environment variables	Environment variables are formatted in an uppercase font. ENVFILE=${APPDIR}
Key names	Key names are presented in boldface type. Press Enter to continue.
Literals	Literals are formatted in a monospace font. class extendSample
Window items	Window items are presented in boldface type. Window items can be window titles, button labels, text edit box names or other parts of the window. Type your password in the Logon window. Select Export to make the service available to the client.

BEA eLink Adapter Documentation

The eLink Adapter documentation consists of the following items:

• BEA eLink Adapter for XML Release Notes

• BEA eLink Adapter for XML User Guide

BEA Publications

The following BEA publications are also available:

• TUXEDO System 6 Reference Manual

• TUXEDO System 6 Programmer's Guide, Volumes 1 and 2

• TUXEDO System 6 FML Programmer's Guide

Other Publications

For more information about XML, refer to the Extensible Markup Language (XML) Specification at www.w3.org. For more information about XML samples provided with this adapter, refer to the Open Applications Group at http://www.openapplications.org

Contact Information

The following sections provide information about how to obtain support for the documentation and software.

Documentation Support

If you have questions or comments about the documentation, you can contact the BEA Information Engineering Group by e-mail at docsupport@beasys.com (For information about how to contact Customer Support, refer to the following section.)

Customer Support

If you have any questions about this version of eLink Adapter, or if you have problems installing and running eLink Adapter, contact BEA Customer Support through BEA WebSupport at www.beasys.com. You can also contact Customer Support by using the contact information provided on the Customer Support Card, which is included in the product package.

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

• Your name, e-mail address, phone number, and fax number

• Your company name and company address

• Your machine type and authorization codes

• The name and version of the product you are using

• A description of the problem and the content of pertinent error messages