eLink TCP for IMS User Guide

 

 

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

 

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

 

Configuring BEA eLink TCP Security

Security Checking from Tuxedo 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

 

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

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

 

Monitoring BEA eLink TCP for IMS

Testing Connectivity with Remote Systems

Monitoring and Troubleshooting OTMA

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

 

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

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

 

System Services Descriptions

TCP/IP for OS/390

LE/370

OS/390

 

Error and Informational Messages

Logical Machine IDs

Messages Returned to the Remote Gateway

Messages Written to the BEA eLink TCP for IMS Message Log

 

Example Configuration Files

 

Sample JCL and User Exits

JCL for Executing eLink TCP for IMS

Executing eLink TCP for IMS

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)

 

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

 

Error and Reason Codes