[Table of Contents] [Index] [Next] About this Document

# About this Document

This Preface includes the following sections:

- Purpose of This Document

- How to Use This Document

- Related Documentation

- Contact Information

## Purpose of This Document

This document provides instructions for installing and configuring the BEA eLink Adapter for R/3 product on a UNIX or Windows NT system.

### Who Should Read This Document

This document is intended for system managers who are responsible for installing products in the UNIX or Windows NT environments and for configuring layered products. Portions of this guide are intended for experienced R/3 users with knowledge of ALE and RFC configuration.

### Prerequisite Knowledge

To use and understand this guide, you must have experience in:

- For UNIX installations, UNIX system management and UNIX scripting in one or more shells, particularly the C Shell (csh).

- For Windows NT installations, Windows NT system management.

- BEA TUXEDO system management.

- Configuring ALE and RFC within R/3.

### How This Document Is Organized

The BEA eLink Adapter for R/3 Installation and Configuration Guide is organized as follows:

- Pre-Installation Tasks describes system requirements and information that you need to review before installing BEA eLink Adapter for R/3.

- Installing BEA eLink Adapter for R/3 provides instructions for installing BEA eLink Adapter for R/3 on UNIX and Windows NT systems.

- Configuring TUXEDO describes how to configure TUXEDO to enable integration with BEA eLink Adapter for R/3.

- Configuring RFC Integration describes how to configure BEA eLink Adapter for R/3 to enable access to Remote Function Calls (RFCs) on your SAP R/3 system. You complete these tasks only if TUXEDO applications will use the RFC Inbound feature of BEA eLink Adapter for R/3.

- Configuring ALE Integration describes how to configure BEA eLink Adapter for R/3 to enable access to Application Linking and Embedding (ALE) on your SAP R/3 system. You complete these tasks only if TUXEDO applications will manage SAP Intermediate Documents (IDOCs) using the ALE Inbound or ALE Outbound features of BEA eLink Adapter for R/3.

- Configuring R/3 Connections describes how to configure the inbound and outbound connections to your SAP R/3 system.

- Managing Your Installation describes ongoing maintenance tasks for your BEA eLink Adapter for R/3 installation.

- Sample cr3.ubb File describes the sample cr3.ubb file that accompanies BEA eLink Adapter for R/3.

## How to Use This Document

This document, the BEA eLink Adapter for R/3 Installation and Configuration 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:

>     <your eLink app directory>/docs/index.htm

Note: The online documentation requires a Web browser that supports HTML version 3.0. Netscape Navigator version 2.02 or Microsoft Internet Explorer version 3.0 or later 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 chapter or appendix you want is displayed and selected in your browser. (To select a chapter or appendix, click anywhere inside the chapter or appendix you want to print. If your browser offers a Print Preview feature, you can use the feature to verify which chapter or appendix you are about to print.)

The BEA eLink Adapter for R/3 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.

Convention | Item
--- | ---
boldface text | Indicates terms defined in the glossary.
Ctrl+Tab | Indicates that you must press two or more keys simultaneously.
italics | Indicates emphasis or book titles.
`monospace text` | Indicates code samples, commands and their options, data structures and their members, data types, directories, and file names and their extensions. Monospace text also indicates text that you must enter from the keyboard. Examples: `#include <iostream.h> void main ( ) the pointer psz` `chmod u+w *` `\tux\data\ap` `.doc` `tux.doc` `BITMAP` `float`
`monospace boldface text` | Identifies significant words in code. Example: `void` `commit``( )`
`monospace italic text` | Identifies variables in code. Example: `String` `expr`
UPPERCASE TEXT | Indicates device names, environment variables, and logical operators. Examples: LPT1 SIGNON OR
`{ }` | Indicates a set of choices in a syntax line. The braces themselves should never be typed.
`[ ]` | Indicates optional items in a syntax line. The brackets themselves should never be typed. Example: `buildobjclient [-v] [-o name ] [-f` `file-list``]... [-l` `file-list``]...`
`|` | Separates mutually exclusive choices in a syntax line. The symbol itself should never be typed.
`...` | Indicates one of the following in a command line: That an argument can be repeated several times in a command line That the statement omits additional optional arguments

- That you can enter additional parameters, values, or other information

  The ellipsis itself should never be typed.

  Example:

  `buildobjclient [-v] [-o name ] [-f` `file-list``]... [-l` `file-list``]...`

`.
.
.`

Indicates the omission of items from a code example or from a syntax line. The vertical ellipsis itself should never be typed.

## Related Documentation

The following sections list the documentation provided with the BEA eLink Adapter for R/3 software as well as other publications related to SAP's R/3 technology.

### BEA eLink Adapter for R/3 Documentation

The BEA eLink Adapter for R/3 information set consists of the following documents:

- BEA eLink Adapter for R/3 Installation and Configuration Guide

- BEA eLink Adapter for R/3 User Guide

  Note: The BEA eLink Adapter for R/3 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 TUXEDO-related BEA publications are also available:

- BEA TUXEDO Administrator's Guide

- BEA TUXEDO Installation and Configuration Guide for UNIX

- BEA TUXEDO Programmer's Guide

- FML Programmer's Guide

- /Q Guide

### Other Publications

For more information about SAP R/3 technology, refer to the following SAP publications. R/3 documentation is provided typically on-line or on CD-ROM. The following headings, based on the SAP R/3 CD-ROM for Version 3.1H of R/3, are applicable:

- Application Link Enabling (ALE)

- Remote Communications

## 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 or by telephone at +1.408.542.4193. (For information about how to contact Customer Support, refer to the following section.)

### Customer Support

If you have any questions about this version of BEA eLink Adapter for R/3, or if you have problems installing and running BEA eLink Adapter for R/3, 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

[Table of Contents] [Index] [Next]