|  | BEA eLink for Mainframe SNA 3.2 Information Center
HOME | SEARCH | CONTACT | PDF FILES | WHAT'S NEW
| TABLE OF CONTENTS | PREVIOUS TOPIC | NEXT TOPIC

# About This Information Center

## Purpose

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 or IMS 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:

  - "Introducing the BEA eLink SNA System"

  - "Understanding How the Software Works"

  - "Configuring the System"

  - "Verifying the Software"

  - "Administering the Application Domain"

  - "Security"

  - "Data Translations"

  - "Application to Application Programming Considerations"

  - "APPC/IMS Programming Considerations"

  - "CICS/ISC 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

  - Index

  ## 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 on-line version of this documentation, open the following HTML file in a Web browser:

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

  ### Printing the PDF File

  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

  ### BEA eLink SNA 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.2 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

  ### 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 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.

  Copyright © 1999 BEA Systems, Inc. All Rights Reserved.
  Required browser version: Netscape Communicator version 4.0 or higher, or Microsoft Internet Explorer version 4.0 or higher.
  Last update: October 1, 1999.