eLink TCP for Tuxedo User Guide

 

 

Introducing BEA eLink TCP for Tuxedo

BEA eLink TCP for Tuxedo and the BEA Tuxedo Architecture

Operational Considerations

BEA eLink TCP Functionality

Domains-based Gateway Connectivity

Security

Connection Multiplexing

Domain Name Server Support

GWIDOMAIN Gateway Component

How eLink TCP for Tuxedo Affects BEA Tuxedo Application Programs

VIEW Definitions

FML Buffer Support

How eLink TCP for Tuxedo Affects BEA Tuxedo Administration

 

Understanding How BEA eLink TCP for Tuxedo Works

Planning Your Configuration

Initializing eLink TCP for Tuxedo

Processing Local Service Requests

Step 1: Receiving a Service Request from BEA Tuxedo Software

Step 2: Connecting to a Remote System

Step 3: Converting Input Buffer Types

Step 4: Translating Input Data

Step 5: Transmitting the Service Request

Step 6: Receiving a Reply

Step 7: Translating the Reply

Step 8: Converting Output Data

Step 9: Sending the Reply to the Caller

Processing Remote Service Requests

Processing Shut Down Requests

Programming Considerations

Input and Output Issues

Preparing Input and Output Data with eLink TCP for Tuxedo

Service Request Parameters

Output Data Considerations

Limitations on the Use of Certain ATMI Functions

Conversational Communication Functions

Non-Transactional Communications

The tpsprio( ) and tpgprio( ) Functions

The tpbroadcast() and tpnotify() Functions

Error Handling

Gateway Errors

Remote System Failures

Application Errors

 

Configuring BEA eLink TCP for Tuxedo for Data Mapping

Converting Input and Output Data

Buffers and Records

Buffers Received from Local Programs

Records Received from Remote Programs

Managing Parameters for Buffer and Record Conversion

Parameters for Locally Originated Calls

Guidelines for Mapping Input Buffers to Input Records

Guidelines for Mapping Output Records to Output Buffers

Parameters for Remotely Originated Calls

Guidelines for Mapping Input Records to Input Buffers

Guidelines for Mapping Output Buffers to Output Records

Mapping Buffers to Records

Setting the INBUFTYPE and INRECTYPE Parameters

Mapping Records to Buffers

Setting the OUTRECTYPE and OUTBUFTYPE Parameters

Creating VIEW Definitions to Facilitate Buffer Conversion

Preparing VIEW Definitions

Translating Data

Data Translation Rules

NULL Characters in String Length Calculations (C Programs)

NULL Characters in String Length Calculations (COBOL Programs)

Converting Numeric Data

Encoding COBOL Data Types

Using the COBOL Data Encoding Library

Encoding for All Services

Encoding Messages To and From a Specific Host

Using Code Page Translation Tables

Specifying a Translation Table

How the Translation Tables Work

Troubleshooting Translation Table Errors

Sample DMCONFIG Definition for ASCII to EBCDIC Translations

 

Setting Up Security for BEA eLink TCP for Tuxedo

Security Checking from Tuxedo to Mainframe

Security Checking from Mainframe to Tuxedo

Setting Up Security

Tuxedo Security Plug-in

Built-in Tuxedo Security

Sample Security Files

Data Area Security

Enabling Data Area Security

Format

 

Configuring BEA eLink TCP for Tuxedo

Updating the BEA Tuxedo UBBCONFIG File

Updating the GROUPS Section to Establish a Server Group

Syntax

Example

Updating the SERVERS Section

Syntax

Using the Request Logging Option

Other Options for Configuring Servers

Specifying Parameters in the GWICONFIG File

Defining the GLOBAL Section of the GWICONFIG File

Defining the NATIVE Section of the GWICONFIG File

Defining the FOREIGN Section of the GWICONFIG File

Defining the LOCAL_SERVICES Section of the GWICONFIG File

Defining the REMOTE_SERVICES Section of the GWICONFIG File

Defining Domain Configurations in the DMCONFIG File

DM_LOCAL_DOMAINS Section

DM_REMOTE_DOMAINS Section

DM_ACCESS_CONTROL Section

DM_LOCAL_SERVICES Section

DM_REMOTE_SERVICES Section

DM_ROUTING Section

Sample DMCONFIG File

 

Starting BEA eLink TCP for Tuxedo

Setting Environment Variables

Invoking eLink TCP for Tuxedo

Administering the Gateways

 

Error and Information Messages

 

Code Page Translation Tables

Modifying a Code Page Translation Table

Default Tuxedo

United States (00819x00037)

Germany (00819x00273)

Finland/Sweden (00819x00278)

Spain (00819x00284)

Great Britain (00819x00285)

France (00819x00297)

Belgium (00819x00500)

Portugal (00819x00860)

Latin-1 (00819x01047)

Latin-2 (00912x00870)