1. Introducing BEA eLink TCP for IMS
Features/Benefits
BEA eLink TCP for IMS Architecture
BEA eLink TCP Functionality
Domains-based Gateway Connectivity
Security
Domain Name Server Support
Dynamic Configuration
Required System Components
BEA eLink Gateway Program
IBM LE/370
IBM TCP/IP for OS/390
IMS Server Transactions
IMS Client Transactions
2. Understanding How BEA eLink TCP for IMS Works
Inbound Processing
Outbound Processing
How BEA eLink TCP for IMS Is Initialized
Processing IMS Server Requests
Processing IMS Client Requests
Two Phases of an IMS Client Request
How BEA eLink TCP for IMS Processes an IMS Client Request
How BEA eLink TCP for IMS Shuts Down
3. Configuring BEA eLink TCP for IMS
System Configuration Parameters
Syntax of the SYSTEM Statement
Description of SYSTEM Parameters
Defining the Local Host
Syntax of the HOST Statement
Description of the Parameters
Defining the Local Gateway
Syntax of the GATEWAY TYPE=LOCAL Statement
Description of GATEWAY TYPE=LOCAL Parameters
Defining Remote Gateways
Syntax of the GATEWAY TYPE=REMOTE Statement
Description of GATEWAY TYPE=REMOTE Parameters
Defining Remote Services
Syntax of the SERVICE TYPE=REMOTE Statement
Description of SERVICE TYPE=REMOTE Parameters
Defining Local Services
Syntax of the SERVICE TYPE=LOCAL Statement
Description of Parameters
Configuring eLink TCP Security
Security Checking from UNIX to Mainframe
Security Checking from Mainframe to UNIX
Setting Up Security for eLink TCP for IMS
Securing Connections from IMS to UNIX
Securing Connections from IMS to IMS
Securing Connections from IMS to CICS
Securing Services
Dynamically Configuring eLink TCP for IMS
Modifying SYSTEM Parameters
Writing the Configuration to a File
Processing a File
Changing Gateway Configurations
Adding a Gateway
Starting a Gateway
Stopping a Gateway
Modifying an Existing Gateway
Changing IMS Host Configurations
Adding a Host
Starting a Host
Modifying an Existing Host
Stopping a Host
Changing Remote Service Definitions
Adding a Remote Service
Stopping a Remote Service
Modifying an Existing Remote Service
Starting a Remote Service
Changing Local Service Definitions
Adding a Local Service
Stopping a Local Service
Modifying an Existing Local Service
Starting a Local Service
Display Status Information
4. Monitoring BEA eLink TCP for IMS
Testing Connectivity with Remote Systems
Operating BEA eLink TCP for IMS
Initialization
Normal Operation
Operator Commands
Issuing Session-related Messages
Termination
SHUTDOWN Command
A Client-Initiated Shutdown
The BEA eLink TCP for IMS Message Log
Message Format
OS/390 Console Messages
The Server Response Log File
5. Programming BEA eLink TCP for IMS
Programming Your Application
Programming Interface
IMS Server Requests
Message Format
Field Descriptions
Header Files and Copybooks
Returning a Response
Batch Message Program Gateway
OTMA Client Gateway
IMS Client Requests
Message Format
Field Descriptions
Header Files and Copybooks
Error Handling
Types of Errors
Other Errors
How BEA eLink TCP for TUXEDO Translates Data
BEA TUXEDO Buffer Types
Data Translation Rules
Strings and Numeric Data: A Closer Look
Including NULL Characters in String Length Calculations
Converting Numeric Data
A. System Services Descriptions
IMS
TCP/IP for OS/390
LE/370
OS/390
B. Error and Informational Messages
Logical Machine IDs
Messages Returned to the Remote Gateway
Messages Written to the BEA eLink TCP for IMS Message Log
C. Example Configuration Files
BMP Configuration
System Configuration
Single Inbound Session
Multiple Inbound Sessions
Multiple Outbound Sessions
OTMA Configuration
D. Sample JCL and User Exits
JCL for eLink TCP for IMS
Executing BEA eLink TCP for IMS as a BMP
Notes
Executing eLink TCP for IMS as OTMA
Sample User Exits Enabling IMS Clients to Communicate to Remote
Services
OTMA Prerouting User Exit (DFSYPRX0)
Sample DSECT BEAOTM
OTMA Destination Resolution User Exit (DFSYDRU0)
E. Sample IMS Client and Server Transactions
IMS Server Transaction
BEASVR01 - A Sample IMS Server Transaction
Notes
IMS Client Transactions
Request Phase
Response Phase
BEACRQ01 - A Sample IMS Client Request Transaction
Notes
BEACRP01 - A Sample IMS Client Response Transaction
Notes
BEACRR01 - A Sample IMS Client Request/Response Transaction
Notes
BEA eLink TCP for CICS Document Information
Copyright information
Organization
Documentation Conventions
Documentation Support
Customer Support