Contents

Preface

Purpose of This Document

Who Should Read This Document

How This Document Is Organized

How to Use This Document

Opening the Document in a Web Browser

Document Conventions

BEA eLink Data Integration Option Documentation

BEA Publications

Other Publications

Contact Information

Documentation Support

Customer Support

1. Understanding the Data Integration Option

Using the BEA Solution for Data Mapping

Using Data Mapping with a Mainframe Environment

Using Data Mapping with SAP R/3 IDOCs

: FML32 Value Buffers with SAP R/3

Using Data Mapping with Other eLink Integrators

Requirements for Data Mapping

BEA eLink Integrator Components

: TUXEDO elinkmerc Server
: FML and VIEW Importer

Mercator Components

: Importers
: Type Editor
: Map Editor

Overview of the eLink Integrator Data Mapping Process

Development Phase

: Using Importers to Create Mercator Type Tree Files
: Compiling Type Tree Files into Mercator Map Files

Execution Phase

: Setting Up the Execution Environment
: Initiating a Service Request for Data Mapping

2. Installing BEA eLink Integrator

Installation Prerequisites

Installing on the Development Platform (Windows NT)

Installing on the Execution Platform

Installing for Execution on Windows NT

Installing for Execution on a UNIX Platform (HP-UX, AIX, or
SUN Solaris)

Distribution Libraries and Executables

Uninstalling eLink Integrator on Windows NT

3. Configuring the Environment for eLink Integrator

Configuring the elinkmerc Server to Run with eLink Integrator

Define the elinkmerc Server

Advertise the Services for Data Mapping

Sample UBBCONFIG File for Data Mapping

Configuring the eLink for Mainframe Gateway to Run with eLink Data Integration Option

4. Data Mapping Conversion

Preparing for Data Mapping Conversion

Creating Files for Conversion

: Creating an FML Group Format File
: Using the mti2fgf Utility

Transferring Files to Development Environment

Developing Rules for Conversions Between FML Buffers and Other
Applications

Set System Properties for the Mercator Open Edition Client

Create an FML Type Tree File Using the FML and View Importer

: FML Type Tree Fields

Create a non-FML Type Tree File Using Importers

: Control Information for TUXEDO /Q

Create a Mercator Map File

Required Files for Conversion Process

Executing a Service Request with Data Mapping

Transfer Files to APPDIR in the Execution Environment

Set Environment Variables

Start BEA TUXEDO and Other Remote Applications

Write a Client Program to Create FML Buffers

Issue a Service Request for Data Mapping

A. Transaction Support

Transactional Message Broker

B. Error and Informational Messages

C. Data Mapping Worksheet

Step 1: Install Products

Step 2: Set TUXEDO Environment Variables

Step 3: Put Mercator in the System Path

Step 4: Transfer Source Files to Windows NT

Step 5: UBBCONFIG File Definitions

Step 6: DMCONFIG File Definitions (Optional)

Step 7: Create an FML Type Tree File

Step 8: Create a non-FML Type Tree File

Step 9: Create a Mercator Map File

Step 10: Port Map Files for Execution on UNIX Platforms

Step 11: Renaming Meta-Type Information File (Optional)

Step 12: Transfer Files

Step 13: Start BEA TUXEDO and Remote Applications

Step 14: Issue a Service Request for Data Mapping