Contents for BEA eLink Adapter Development Kit User Guide

 

 

About This Document

What You Need to Know

e-docs Web Site

How to Print the Document

Contact Us!

Documentation Conventions

 

Understanding The BEA eLink System

BEA eLink Solution Overview

BEA eLink Adapter Overview

BEA eLink Adapter Development Kit Overview

BEA eLink Platform Architecture

 

Understanding the BEA eLink Platform

ATMI Runtime Services

FML32

FML Buffers

Mapping Field Names to Field Identifiers

Creating Field Names

ud32 Client

FML32 Primitives

eLink Commands

Commonly Used TUXEDO Commands

Commonly Used tmadmin Commands

Hardware Requirements for the eLink Platform

Special Instructions for Installing the TUXEDO Core

Preparing the License File

About the TUXEDO Simple Application

Setting Environment Variables

Configuring the Simple Application

Building the Client and Server for the Simple Application

For UNIX Operating Systems

For Windows NT Operating Systems

Booting the Simple Application

Shutting Down the Simple Application

 

Understanding Adapter Architecture and Design

eLink Adapter Architecture Overview

The Server Module

The Configuration Processing Module

Adapter Design Pseudo Code

The TPSVCINFO Structure

Application to eLink Adapters

eLink to Application Adapters

eLink Adapter Configuration

Standards for Adding an eLink Adapter to the UBBCONFIG File

Sample UBBCONFIG File

eLink Adapter Configuration Files

Structure of the eLink Adapter Configuration File

The SERVER Section

The SERVICE Section

The FIELDMAP Section

Sample Adapter Configuration File

API to Parse and Store Configuration Data

API to Parse the Configuration File

API to Store the Configuration Data

Error Handling

Business Level Exceptions

Infrastructure Level Exceptions

Message Catalog

API to Access the Message Catalog File

Tracing

Trace Levels

Tracing Functions and Macros

Deployment and Installation of eLink Adapters

Installation Directory Structure for Components

Naming Convention for Source and Executable Files

 

Installing the eLink ADK and Sample Adapters

What is Included in the eLink ADK

Include Files and Libraries

The Sample Application to eLink Adapter

The Sample eLink to Application Adapter

The Sample E-Mail Adapter

Installing the eLink Adapter Development Kit

Installing on the Windows NT Platform

Installing on the HP-UX, AIX, Solaris, and Compaq TRU64 UNIX Platforms

 

Configuring and Running the Sample Adapters

Demo Prerequisites for UNIX

The Sample Application to eLink Adapter

Configuring the Sample Application to eLink Adapter

Building and Running the Sample Application to eLink Adapter

The Sample eLink to Application Adapter

Configuring the Sample eLink to Application Adapter

Building and Running the Sample eLink to Application Adapter

The Sample E-Mail Adapter

Invoking the Sample E-Mail Adapter

Configuring the Sample E-Mail Adapter

Building and Running the Sample E-Mail Adapter

 

eLink Adapter Development Kit References

Configuration Processing API

eLA_OpenTagFile

eLA_CloseTagFile

eLA_CloseTagHandle

eLA_GetFirstSection

eLA_GetNextSection

eLA_GetFirstProperty

eLA_GetNextProperty

eLA_GetPropertyValue

eLA_GetFieldMap

eLA_GetFirstField

eLA_GetNextField

Hash Table API

eLA_InitHashTable

eLA_DestHashTable

eLA_put

eLA_get

eLA_hash

Utility Functions and Macros

eLA_catentry

eLA_chkeLinkLic

eLA_CloseCatalogFile

eLA_GetConfigFileName

eLA_hexdump

eLA_log

eLA_OpenCatalogFile

eLA_SetServerMsgLevel

ELACATENTRY

ELAIFTRACE

ELATRACE

Definitions and Typedefs

 

ATMI References

Client Membership

tpinit

tpterm

Buffer Management

tpalloc

tprealloc

tpfree

tptypes

Request/Response

tpcall

tpacall

tpgetrply

tpcancel

Service Entry and Return

tpsvrinit

tpsvrdone

tpreturn

Dynamic Advertisement

tpadvertise

tpunadvertise

 

FML32 API

Fadd, Fadd32

Fchg, Fchg 32

Ffind, Ffind32

Fget, Fget32

Fielded, Fielded32

Finit, Finit32

Fldid, Fldid32

Fneeded, Fneeded32

Fsizeof, Fsizeof32

Example of a Server that Uses FML32

 

Tuxedo Commands

buildclient

buildserver

tmadmin

tmboot

tmloadcf

tmshutdown

ud, ud32, wud, wud32

 

Servopts

 

Error Messages

Source Module adklog.c

Source Module cfgfns.c

Source Module chkelinklic.c