Contents

Title Page

Copyright Page

Preface

Purpose of This Guide

Who Should Read This Guide

How This Manual Is Organized

How to Use This Manual

Online Document Considerations
Opening the Manual in a Web Browser
Printing from a Web Browser
Document Conventions

Related Documentation

Connect TCP Documentation
Product Manuals
Other Publications

Contact Information

Documentation Support
Customer Support

1. Introducing BEA Connect TCP for IMS

Product Overview

Features/Benefits

BEA Connect TCP for IMS Architecture

Minimum Hardware Requirements

Software Requirements

BEA Connect TCP for IMS Components

Batch Message Processing Program
IBM LE/370 Language Environment
IBM TCP/IP for MVS
IMS Server Transactions
IMS Client Transactions

2. Understanding How BEA Connect TCP for IMS Works

Overview of Operations

Inbound Processing

Outbound Processing

How BEA Connect TCP for IMS Is Initialized

Processing IMS Server Requests

What Is an IMS Server Request?
How BEA Connect TCP for IMS Processes an IMS Server Request

Processing IMS Client Requests

What Is an IMS Client Request?
Two Phases of an IMS Client Request
How BEA Connect TCP for IMS Processes an IMS Client Request

How BEA Connect TCP for IMS Shuts Down

3. Installing BEA Connect TCP for IMS

How to Install BEA Connect TCP for IMS

4. Configuring BEA Connect TCP for IMS

System Configuration Parameters

Syntax of the SYSTEM Statement
Description of the Parameters

Defining the Local (IMS) Gateway

Syntax of the GATEWAY TYPE=LOCAL Statement
Description of the Parameters

Defining Remote (TPS, CICS, IMS) Gateways

Syntax of the GATEWAY TYPE=REMOTE Statement
Description of Parameters

Defining Remote Services

Syntax of the SERVICE TYPE=REMOTE Statement
Description of Parameters

5. Administering BEA Connect TCP for IMS

Starting BEA Connect TCP for IMS

Initialization

Normal Operation

Termination

Testing Connectivity with Remote Systems

The Configuration File

Local Gateways

Remote Gateways

Remote Services

The BEA Connect TCP for IMS Message Log

MVS Console Messages

The Server Response Log File

Operator Commands

SHUTDOWN Command

A Client-Initiated Shutdown

6. Programming BEA Connect TCP for IMS

Programming Your Application

Programming Interface

IMS Server Requests

Message Format
Field Descriptions
Header Files and Copybooks

Returning a Response

IMS Client Requests

Message Format
Field Descriptions
Header Files and Copybooks

Error Handling

Error Code

Reason Code

Types of Errors

Invalid Request Format
Remote System Not Available
Request Timeout

Remote System Errors

Other Errors

How BEA Connect TPS Translates Data

Process Overview

BEA TUXEDO Terminology

Data Translation Rules

Strings and Numeric Data: A Closer Look
Including NULL Characters in String Length Calculations
Converting Numeric Data

A. System Services Used by BEA Connect TCP for IMS

Description of IMS Services

Description of TCP/IP for MVS Services

Description of LE/370 Services

Description of MVS Services

B. Error and Informational Messages

Logical Machine IDs (LMIDs)

LMID Examples
Messages Returned to the Remote Gateway
Messages Written to the BEA Connect TCP for IMS Message Log

C. Example Configuration File

Single Inbound Session

Multiple Inbound Sessions

Multiple Outbound Sessions

D. Sample JCL

Link BEA Connect TCP for IMS BMP
Execute BEA Connect TCP for IMS BMP
Notes

E. Sample IMS Client and Server Transactions

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

F. Error and Reason Codes

Error Code Chart