Preface

BEA eLink TCP for Mainframe for IMS (hereafter referenced as eLink TCP for IMS) is a gateway connectivity feature that enables OLTP application programs on BEA TUXEDO systems to perform various non-transactional tasks with application programs that reside on IMS.

Purpose of This Document

This document describes the eLink TCP product and gives instructions for configuring and administering a gateway system.

Who Should Read This Document

This document is intended for system administrators who configure and administer the eLink TCP system. In addition, programmers can find useful information for developing client programs and service routines that exchange data with the remote BEA eLink gateways.

How This Document Is Organized

The BEA eLink TCP for IMS User Guide is organized as follows:

• Introducing BEA eLink TCP for IMS provides a description of concepts and processes.

• Understanding How BEA eLink TCP for IMS Works describes how to develop applications that exchange data with a remote BEA eLink gateway.

• Configuring BEA eLink TCP Security describes how to configure security for the gateway.

• Configuring BEA eLink TCP for IMS describes how to create the configuration file and dynamically change configurations.

• Monitoring BEA eLink TCP for IMS describes how to start the eLink TCP application and test connectivity with remote BEA eLink gateways. It also provides information on implementing the gateway system and handling errors.

• Programming BEA eLink TCP for IMS describes how to program your application in COBOL, including message formats and field descriptions.

• System Services Descriptions describes various OS/390, IMS, and TCP/IP services used by eLink TCP.

• Error and Informational Messages describes messages and resolutions for the system.

• Example Configuration Files provides sample configurations.

• Sample JCL and User Exits provides sample job control language (JCL) required to install and execute the eLink TCP application.

• Sample IMS Client and Server Transactions provides sample IMS client and server transactions for use with the eLink TCP application.

• Error and Reason Codes describes error and reason codes issued by the gateway.

• Glossary identifies and defines eLink TCP terminology.

How to Use This Document

The BEA eLink TCP for IMS User Guide is designed primarily as an online, hypertext document. If you are reading this as a paper publication, note that to get full use from this document you should install and access it as an online document via a Web browser.

The following sections explain how to view this document online, and how to print a copy of this document.

Opening the Document in a Web Browser

To access the online version of this document, open the following HTML file in a Web browser.

http://(directory path to eLink TCP HTML files)/index.htm

Note: The online documentation requires a Web browser that supports HTML 3.0. Netscape Navigator 4.0 or higher, or Microsoft Internet Explorer 4.0 or higher are recommended.

Printing from a Web Browser

You can print a copy of this document, one file at a time, from the Web browser. Before you print, make sure that the major topic you want is displayed and selected in your browser. (To select a major topic, click anywhere inside the major topic you want to print. If your browser offers a Print Preview feature, you can use the feature to verify which major topic you are about to print.)

The BEA eLink TCP Online Documentation CD also includes Adobe Acrobat PDF files of all of the online documents. You can use the Adobe Acrobat Reader to print all or a portion of each document.

Documentation Conventions

The following documentation conventions are used throughout this document.

Related Documentation

The following sections list the documentation provided with the eLink TCP for IMS software, and other publications related to online transaction processing (OLTP) technology.

BEA eLink TCP Documentation

BEA eLink TCP documentation consists of the following items:

• BEA eLink TCP Installation Guide

• BEA eLink TCP for IMS User Guide

• BEA eLink TCP for CICS User Guide

• BEA eLink TCP for TUXEDO User Guide

• BEA eLink TCP Release Notes

  Note: The BEA eLink TCP Online Documentation CD also includes Adobe Acrobat PDF files of all of the online documents. You can use the Adobe Acrobat Reader to print all or a portion of each document.

BEA Publications

The following BEA publications are also available:

• BEA TUXEDO System 6 Reference Manual

• BEA TUXEDO System 6 Programmer's Guide, Volumes 1 and 2

Other Publications

For more information about OLTP technology, refer to the following books:

• The TUXEDO System (Andrade, Carges, Dwyer, Felts)

• TUXEDO: An Open Approach to OLTP (Primatesta)

• Building Client/Server Applications Using TUXEDO (Hall)

Contact Information

The following sections provide information about how to obtain support for the documentation and software.

Documentation Support

If you have questions or comments on the documentation, you can contact the BEA Information Engineering Group by e-mail at docsupport@beasys.com. (For information about how to contact Customer Support, refer to the following section.)

Customer Support

If you have any questions about this version of eLink TCP, or if you have problems installing and running eLink TCP, contact BEA Customer Support through BEA WebSupport at www.beasys.com. You can also contact Customer Support by using the contact information provided on the Customer Support Card, which is included in the product package.

When contacting Customer Support, be prepared to provide the following information:

• Your name, e-mail address, phone number, and fax number

• Your company name and company address

• Your machine type and authorization codes

• The name and version of the product you are using

• A description of the problem and the content of pertinent error messages