[Top] [Prev] [Next] [Bottom]

# Preface

## Purpose of This Manual

This guide provides information about Connect SNA, a TUXEDO multi-domain connectivity product which enables client/server communications between MVS/CICS programs and TUXEDO applications via a Systems Network Architecture (SNA) network.

### Scope

This guide explains BEA Connect SNA technical concepts and provides step-by-step procedures for:

- Installing and configuring Connect SNA platform software

- Administering the Connect SNA gateway

- Programming TUXEDO applications for transactional conversations with IBM CICS programs.

### Who Should Read This Manual

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

#### Administrators

As the application administrator of a BEA TUXEDO System, you will configure Connect 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 Connect SNA and CICS resources from data center systems personnel and use those names to configure the local SNA stack.

#### Operators

BEA TUXEDO operators 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 This Manual Is Organized

The BEA Connect SNA User Guide is organized as follows:

- Introducing BEA Connect SNA

- Understanding How BEA Connect SNA Works

- Installing BEA Connect SNA

- Configuring BEA Connect SNA

- Administering the BEA Connect SNA Application Domain

- Verifying BEA Connect SNA

- Programming Considerations

In addition, the appendixes contain information about:

- Reference Pages (formerly called man pages)

- ATMI to CPI-C Function Mapping

- CPI-C Parameters and Values

- Error Messages

- Sample VTAM Configurations

- Glossary

## How to Use This Manual

### Online Document Considerations

This document, BEA Connect SNA User Guide, is designed primarily as an online, hypertext guide. If you are reading this as a paper publication, note that to get full use from this guide you should install and access it as an online document via a Web browser that supports HTML 3.0. Netscape Navigator 2.02 or Microsoft Internet Explorer 3.0 or later are recommended. (Information on how to install the online documentation is available in the BEA Connect SNA Release Notes.)

### Opening the Manual 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 Connect SNA HTML files)/index.htm

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 are recommended.

Figure 1 shows the online guide with the clickable navigation bar and table of contents.

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

> Figure 1 BEA Connect SNA User Guide Displayed in Netscape Web Browser

### 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 Connect server. Server1 is the host name of a Jolt server.

## Related Documentation

### Connect SNA Documentation

The Connect SNA documentation consists of the following items:

BEA Connect SNA User Guide

BEA Connect SNA 2.0 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 Technical Support, refer to the following section.)

### Technical Support

If you have a question you cannot answer using this guide or the BEA Connect SNA Release Notes, you can contact BEA Connect SNA Technical 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

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

You may also send questions to BEA Connect SNA Technical Support by fax to +1.408.743.4071 or by e-mail to support@beasys.com.

[Top] [Prev] [Next] [Bottom]