This preface describes the what you can expect to find in this document, and contains the following:

• About This Guide

• What You Should Know

• Typographic Conventions

• User Roles

• Supported Platforms

• System Requirements

About This Guide

---

This guide describes the concepts you need to know to use iPlanet Application Server Enterprise Connector for SAP R/3 iPlanet Application Serverand how to configure and use the components provided with iPlanet Application Server Enterprise Connector for R/3. This document also describes how to write your servlet or Enterprise Java Bean (EJB) to access an R/3 program on the mainframe. It also contains information about the Application Programming Interfaces (APIs) that you need to use.

What You Should Know

---

This guide assumes you are familiar with the following topics:

• iPlanet Application Server Programming Concepts. See iPlanet Application Server Programmer's Guide for more details

• The Internet and World Wide Web

• R/3 Programming Concepts

• Java Programming Language

Documentation Conventions

---

File and directory paths are given in Windows format with backslashes separating directory names. For Unix versions, the directory paths are the same, except slashes should be substituted in place of backslashes.

This guide uses URLs of the form:

http://server.domain/path/file.html

In these URLs, server is the name of the server on which you run your application; domain is your Internet domain name; path is the directory structure on the server; and file is an individual filename. Italics items in URLs are placeholders.

This guide uses the following font conventions:

• The monospace font is used for sample code and code listings, API and language elements (such as function names and class names), file names, pathnames, directory names, and HTML tags.

• Italic type is used for book titles, emphasis, variables and placeholders, and words used in the literal sense.

How this Guide is Organized

---

This guide is organized into the following chapters:

Chapter 1, "Installation and Administration" describes concepts you should be familiar with before you set up iPlanet Application Server Enterprise Connector for R/3 or use the API in servlets or EJBs.

Chapter 2, "Managing the Data Sources and User Privileges" describes how to use the management console, browse the R/3 message definitions, specify the output directory, and generate and load an XML file into the repository.

User Roles

---

This section describes the roles various users take, and their tasks.

People with a variety of skills are involved with the setup of iPlanet Application Server for R/3. Some of these users are listed below:

System Administrator	This is the person responsible for iPlanet Application Server Enterprise Connector for R/3 installation.
Systems or Business Analyst	This person uses the R/3 Data Mining Tool to define the R/3 transactions that will be available through iPlanet Application Server Enterprise Connector for R/3. This person uses the Management Console to specify levels of security, which end users have access to specific kinds of data, and performance characteristics such as pooling. This topic is discussed in
Applications Programmer	This person writes servlets or EJBs that call the UIF API. This person also uses the Repository Browser to determine the available data types and access methods.
R/3 Programmer	Writes new R/3 programs that perform advanced communications with iPlanet Application Server Enterprise Connector for R/3.

Supported Platforms

---

iPlanet Application Server for R/3 supports:

Vendor	Platform
Microsoft	Windows NT version 4.0 with Service Pack 5
Sun	SPARC running Solaris 2.6

System Requirements

---

• iPlanet Application Server Version 6.0

• SAP R/3 Version 4.5B

• 50MB disk space, 64MB memory minimum, 128MB recommended