1. 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
2. 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
3. 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
Configuring the Gateway for Alternate Data Mapping Tools
Specifying the Alternate Data Mapping Product in the UBBCONFIG File
Advertise the Services for Data Mapping
Sample UBBCONFIG File for Data Mapping
Specifying Alternate Data Mapping in the DMCONFIG File
Specifying the Alternate Data Mapping Service in DM_LOCAL_SERVICES
Specifying the Alternate Data Mapping Service in DM_REMOTE_SERVICES
Configuring the elinkmerc Server to Run with eLink Adapter
Define the elinkmerc Server
4. Setting Up Security for BEA eLink TCP for TUXEDO
Security Checking from UNIX to Mainframe
Security Checking from Mainframe to UNIX
Setting Up Security
Sample Security Files
User Files
Group File
ACL File
Data Area Security
Enabling Data Area Security
Format
5. 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
Other Options for Configuring Servers
Example
Define the elinkmerc Server as an Alternate Data Mapping Tool (Optional)
Updating the SERVICES Section
Advertise the Services for Data Mapping
Specifying Parameters in the GWICONFIG File
Defining the GLOBAL Section of the GWICONFIG File
Syntax
Required Parameters
Optional Parameters
Defining the NATIVE Section of the GWICONFIG File
Syntax
Required Parameters
Optional Parameters
Defining the FOREIGN Section of the GWICONFIG File
Syntax
Required Parameters
Optional Parameters
Defining the LOCAL_SERVICES Section of the GWICONFIG File
Syntax
Required Parameters
Optional Parameters
Defining the REMOTE_SERVICES Section of the GWICONFIG File
Syntax
Required Parameters
Optional Parameters
Defining Domain Configurations in the DMCONFIG File
DM_LOCAL_DOMAINS Section
Syntax
Required Parameters
Optional Parameters
DM_REMOTE_DOMAINS Section
Syntax
Required Parameters
Optional Parameters
DM_ACCESS_CONTROL Section
Syntax
Required Parameters
Optional Parameters
DM_LOCAL_SERVICES Section
Syntax
Required Parameters
Optional Parameters
DM_REMOTE_SERVICES Section
Syntax
Required Parameters
Optional Parameters
DM_ROUTING Section
Syntax
Required Parameters
Optional Parameters
Sample DMCONFIG File
6. Starting BEA eLink TCP for TUXEDO
Setting Environment Variables
Invoking eLink TCP for TUXEDO
Administering the Gateways
A. Error and Informational Messages
B. 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)
BEA eLink TCP for TUXEDO Document Information
Copyright information
Organization
Documentation Conventions
Documentation Support
Customer Support