1. Introducing BEA eLink TCP for TUXEDO
BEA eLink TCP for TUXEDO and the BEA TUXEDO Architecture
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
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. Getting Ready to Configure BEA eLink TCP for TUXEDO
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
The INBUFTYPE Parameter
The INRECTYPE Parameter
Guidelines for Mapping Output Records to Output Buffers
The OUTBUFTYPE Parameter
The OUTRECTYPE Parameter
Parameters for Remotely Originated Calls
Guidelines for Mapping Input Records to Input Buffers
The INBUFTYPE Parameter
The INRECTYPE Parameter
Guidelines for Mapping Output Buffers to Output Records
The OUTBUFTYPE Parameter
The OUTRECTYPE Parameter
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
Enabling eLink TCP Security
Security Checking from UNIX to Mainframe
Security Checking from Mainframe to UNIX
Setting Up Security
Sample Security Files
User Files
Group File
ACL File
Considerations for Error Handling
4. 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
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 Gateway 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
5. Starting BEA eLink TCP for TUXEDO
Setting Environment Variables
Invoking eLink TCP for TUXEDO
Administering the Gateways
B. Data Area Security
Enabling Data Area Security
Format
C. Error and Informational Messages
Using the COBOL Data Encoding Library
Encoding for All Services
Encoding Messages To and From a Specific Host
BEA eLink TCP for TUXEDO Document Information
Copyright information
Organization
Documentation Conventions
Documentation Support
Customer Support