Preface

This preface introduces you to the Oracle9iAS Containers for J2EE User's Guide, discussing the intended audience, structure, and conventions of this document. It also provides a list of related Oracle documents.

Intended Audience

This manual is intended for anyone who is interested in using Oracle9iAS Containers for J2EE (OC4J), assuming you have basic knowledge of the following:

Java and J2EE
XML
JDBC

Structure

The Oracle9iAS Containers for J2EE User's Guide contains the following chapters and appendices:

Chapter 1, "J2EE Overview"

This chapter describes OC4J primary features, an overview of J2EE APIs and OC4J support, and tunneling and performance services provided by OC4J.

Chapter 2, "Configuration and Deployment"

This chapter discusses how to install OC4J, how to configure Pet Store, the popular J2EE demo application from Sun Microsystems, and how to deploy a Web application.

Chapter 3, "Advanced Configuration, Development, and Deployment"

This chapter covers advanced OC4J information. It includes an overview of OC4J XML configuration files, how they relate to each other, what happens when you deploy an application, some tips on manual XML configuration file editing for applications, when OC4J automatic deployment for applications occurs, and building and deploying within a directory.

Chapter 4, "Data Sources Primer"

This chapter documents how to use data sources and the JDBC driver.

Chapter 5, "Servlet Primer"

This chapter instructs how to create and use a servlet in OC4J.

Chapter 6, "JSP Primer"

This chapter instructs how to create and use a JSP page in OC4J.

Chapter 7, "EJB Primer"

This chapter instructs how to create and use an EJB in OC4J.

Chapter 8, "Security"

This chapter presents an overview of security features. It describes how to configure authorization and authentication for security.

Chapter 9, "Oracle9iAS Clustering"

This chapter describes how to cluster application server instances, Oracle HTTP Servers, and OC4J instances.

Chapter A, "DCM Command-Line Utility (dcmctl)"

This appendix describes the DCM command-line utility, which is used to bypass the Oracle Enterprise Manager for application deployment, starting or stopping application server instances, and other functions.

Chapter B, "Additional Information"

This appendix describes the elements of the server.xml file, OC4J command-line tool options, and provides configuration and deployment examples.

Conventions

In this manual, Windows refers to the Windows95, Windows98, and Windows NT operating systems.

In examples, an implied carriage return occurs at the end of each line, unless otherwise noted. You must press the Return key at the end of a line of input.

This manual also uses the following conventions:

Convention	Meaning
. . .	Vertical ellipsis points in an example mean that information not directly related to the example has been omitted.
. . .	Horizontal ellipsis points in statements or commands mean that parts of the statement or command not directly related to the example have been omitted
boldface text	Boldface type in text indicates a term defined in the text, the glossary, or in both locations.
< >	Angle brackets enclose user-supplied names.
[ ]	Brackets enclose optional clauses from which you can choose one or none.

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle Corporation is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at

http://www.oracle.com/accessibility/

Accessibility of Code Examples in Documentation

JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle Corporation does not own or control. Oracle Corporation neither evaluates nor makes any representations regarding the accessibility of these Web sites.