About This Information Center

This center provides information about BEA eLink for Mainframe SNA, a BEA TUXEDO multi-domain connectivity product which enables client/server communications between OS390/CICS programs and BEA TUXEDO applications via a Systems Network Architecture (SNA) network.

Scope

This information center explains eLink SNA technical concepts and provides step-by-step procedures for:

• Installing and configuring eLink SNA platform software

• Administering the eLink SNA gateway

• Programming BEA TUXEDO applications for transactional conversations with IBM CICS programs.

Who Should Read This Information

The audience is primarily BEA TUXEDO System application administrators and operators.

Administrators

As the application administrator of a BEA TUXEDO System, you will configure eLink SNA using the DMCONFIG file and its associated dm commands. You must have sufficient SNA knowledge to configure the underlying SNA Stack so it conforms with definitions created in VTAM and CICS for each remote domain. This document provides information to help you understand the relationship between BEA TUXEDO system configuration settings and SNA-based application configuration concepts.

Successfully linking and establishing conversations between BEA TUXEDO system applications and SNA-based programs requires special coordination. The names and characteristics of SNA resources, configured in the SNA stack, must agree with resources and characteristics defined in VTAM and CICS. This guide includes examples of these relationships.

Typically, remote VTAM and CICS resources are defined by system personnel in a data center where IBM mainframes are located. Therefore, you need to request the remote names of eLink SNA and CICS resources from data center systems personnel and use those names to configure the local SNA stack.

Operators

As an operator of a BEA TUXEDO system, you will use existing skills with the BEA TUXEDO domain administration facility to modify SNA domain configurations and get information about the configuration and run-time environment.

Recommended Reading

You should read the BEA TUXEDO Product Overview. Additionally, you should have read and understand the BEA TUXEDO /Domain Guide and the BEA TUXEDO Application Development Guide, which are essential to comprehending the material in this document.

How the Information Is Organized

The BEA eLink for Mainframe SNA Information Center is organized as follows:

• Section 1, "Introducing the BEA eLink SNA System"

• Section 2, "Understanding How the Software Works"

• Section 3, "Configuring the System"

• Section 4, "Verifying the Software"

• Section 5, "Administering the Application Domain"

• Section 6, "Programming Considerations"

In addition, the appendixes contain the following information:

• Appendix A, "Reference Pages" (formerly called man pages)

• Appendix B, "ATMI to CPI-C Function Mapping"

• Appendix C, "CPI-C Parameters and Values"

• Appendix D, "Error Messages"

• Appendix E, "Sample VTAM Configurations"

• Appendix F, "Code Page Translation Tables"

• Glossary

How to Use The Documentation

The Documentation CDROM, included in the package with your product software CDROM, contains both an HTML version of this guide and a PDF version. The HTML version should be viewed as an online browseable document. The PDF version should be used for printing.

Online Document Considerations

This guide is designed primarily as an online, hypertext guide. If you are reading it as a paper publication, to get full use from this guide you should install and access it as an online document. (Information on how to install the online documentation is available in the BEA eLink for Mainframe SNA Release Notes.)

Note: The online documentation requires a Web browser that supports HTML 3.0. Netscape Navigator 2.02 or Microsoft Internet Explorer 3.0 or later.

Opening the information Center in a Web Browser

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

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

You must have the Adobe Acrobat Reader to view and print the PDF file. If you do not have this reader, you can obtain it free of charge from the Adobe Systems Incorporated homesite at www.adobe.com. (Please note that the BEA eLink for Mainframe SNA Information Center contains a hot link to this site.)

Printing from a Web Browser

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

Document Conventions

The following documentation conventions are used throughout this manual:

Item	Convention	Example
Arguments	appear in brackets and are formatted in a lowercase monospace font. Optional arguments are formatted in italic font. Predefined arguments are formatted in an uppercase font. Vertical bars separate arguments from which you may choose only one.	{name, 0, value} {ACCTID | 2 | 5000}
Environment variables	are formatted in an initial uppercase font enclosed in angle brackets.	<Envfile>=${APPDIR}
Literals and parameters	are formatted in a monospace font.	class extendSample and the LOCALLU parameter
Programs, applications, files, and subsystem names	are formatted with uppercase font in text, but are in monospace uppercase or lowercase in code examples.	Use the DMCONFIG file and the CLASS LIBRARY. An aix.env file example is included with your product software
User input	are formatted in a monospace font.	Type cd TUXDIR
Glossary terms	are formatted in italics in the printed copy. Online glossary terms are in italics, color, and may be underlined, depending on your browser settings.	Server1 is the host name of a BEA eLink server. Server1 is the host name of a Jolt server.

Related Documentation

The BEA eLink for Mainframe SNA documentation consists of the following items:

• BEA eLink for Mainframe SNA Installation Guide

• BEA eLink for Mainframe SNA User Guide

• BEA eLink for Mainframe SNA 3.1 Release Notes

Product Manuals

• TUXEDO Product Overview

• TUXEDO /Domain Guide

• TUXEDO Application Development Guide

• TUXEDO System 6 Reference Manual

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

Other Publications

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

• TUXEDO: An Open Approach to OLTP (Primatesta)

• Building Client/Server Applications Using TUXEDO (Hall)

Contact Information

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 on how to contact Customer Support, refer to the following section.)

Customer Support

If you have a question you cannot answer using this guide or the BEA eLink SNA Release Notes, you can contact BEA Customer Support.

When contacting technical 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

North American Support Center

In the USA, you can call Customer Support at +1.888.BEA.SUPT (+1.888.232.7878) or 408.570.8070 between 5:00am and 6:00pm Pacific time. Extended Support Customers may call anytime.

You may also send questions to Customer Support by fax to +1.408.570.8071 or by e-mail to support@beasys.com.

European Support Center

In Paris, France, you can call Customer Support at +08-0-09-05-565 (toll free) or +33-1-41-45-7090 Monday through Friday between 9:00am and 6:00pm GMT+1. Extended Support Customers may call anytime.

You may also send questions to Customer Support by fax to +33-1-41-45-7009 or by e-mail to support@beasys.fr.