Preface

This document is an administrator's guide for Oracle Containers for J2EE (OC4J) customers using the OC4J implementation of the standard J2EE Connector Architecture (J2CA). This governs the use of resource adapters for connecting to and accessing backend Enterprise Information Systems.

The J2CA implementation in Oracle Application Server 10g Release 3 (10.1.3) adheres to the Sun Microsystems J2EE Connector Architecture Specification, Version 1.5.

This preface contains the following sections:

• Audience

• Documentation Accessibility

• Related Documentation

• Conventions

Audience

Most information in this manual is for resource adapter configuration, so OC4J administrators are the primary audience. Secondary audiences include J2EE application component providers and resource adapter providers. See "Roles and Target Audiences" for related information.

You should be familiar with the current version of the J2EE Connector Architecture Specification, produced by Sun Microsystems, although some of its concepts are reviewed here. There is a link to that specification near the end of this preface. Readers should also be familiar with concepts of Java Message Service (JMS) and message-driven beans (MDB).

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. Accessibility standards will continue to evolve over time, and Oracle 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 more information, visit the Oracle Accessibility Program Web site at

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

Accessibility of Code Examples in Documentation

Screen readers 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, some screen readers 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 does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

TTY Access to Oracle Support Services

Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day, seven days a week. For TTY support, call 800.446.2398.

Related Documentation

For more information, see the following Oracle resources.

Additional OC4J documents:

• Oracle Containers for J2EE Developer's Guide

  This document discusses items of general interest to developers writing an application to run on OC4J—issues that are not specific to a particular container such as the servlet, EJB, or JSP container. (An example is class loading.)

• Oracle Containers for J2EE Deployment Guide

  This document covers information and procedures for deploying an application to an OC4J environment. This includes discussion of the deployment plan editor that comes with Oracle Enterprise Manager 10g.

• Oracle Containers for J2EE Configuration and Administration Guide

  This document discusses how to configure and administer applications for OC4J, including use of the Oracle Enterprise Manager 10g Application Server Control Console, use of standards-compliant MBeans provided with OC4J, and, where appropriate, direct use of OC4J-specific XML configuration files.

• Oracle Containers for J2EE Servlet Developer's Guide

  This document provides information for servlet developers regarding use of servlets and the servlet container in OC4J, including basic servlet development and use of JDBC and EJBs.

• Oracle Containers for J2EE Support for JavaServer Pages Developer's Guide

  This document provides information about JavaServer Pages development and the JSP implementation and container in OC4J. This includes discussion of Oracle features such as the command-line translator and OC4J-specific configuration parameters.

• Oracle Containers for J2EE JSP Tag Libraries and Utilities Reference

  This document provides conceptual information as well as detailed syntax and usage information for tag libraries, JavaBeans, and other Java utilities provided with OC4J. There is also a summary of tag libraries from other Oracle product groups.

• Oracle Containers for J2EE Services Guide

  This document provides information about standards-based Java services supplied with OC4J, such as JTA, JNDI, JMS, JAAS, and the Oracle Application Server Java Object Cache.

• Oracle Containers for J2EE Security Guide

  This document (not to be confused with the Oracle Application Server Security Guide) describes security features and implementations particular to OC4J. This includes information about using JAAS, the Java Authentication and Authorization Service, as well as other Java security technologies.

• Oracle Containers for J2EE Enterprise JavaBeans Developer's Guide

  This document provides information about Enterprise JavaBeans development and the EJB implementation and container in OC4J.

Oracle Application Server Web services documents:

• Oracle Application Server Web Services Developer's Guide

  This document describes Web services development and configuration in OC4J and Oracle Application Server.

• Oracle Application Server Advanced Web Services Developer's Guide

  This document describes topics beyond basic Web service assembly. For example, it describes how to diagnose common interoperability problems, how to enable Web service management features (such as reliability, auditing, and logging), and how to use custom serialization of Java value types.

  This document also describes how to employ the Web Service Invocation Framework (WSIF), the Web Service Provider API, message attachments, and management features (reliability, logging, and auditing). It also describes alternative Web service strategies, such as using JMS as a transport mechanism.

• Oracle Application Server Web Services Security Guide

  This document describes Web services security and configuration in OC4J and Oracle Application Server.

Oracle TopLink documents:

• Oracle TopLink Getting Started Guide

• Oracle TopLink Developer's Guide

Additional Oracle Application Server documents:

• Oracle Application Server Administrator's Guide

• Oracle Application Server Security Guide

• Oracle Application Server Performance Guide

Oracle Enterprise Manager 10g Application Server Control online help topics, available through the Application Server Control Console:

• Task and conceptual topics

• Context-sensitive topics

Oracle JDeveloper documentation:

• Oracle JDeveloper online help

• Oracle JDeveloper documentation on the Oracle Technology Network:

  http://www.oracle.com/technology/products/jdev/index.html
  
  

Resources from Sun Microsystems:

• Web site for the J2CA 1.5 specification:

  http://java.sun.com/j2ee/connector/download.html
  
  

• Web site for general J2EE 1.4 documentation:

  http://java.sun.com/j2ee/1.4/docs/
  
  

• Web site for J2EE 1.4 Javadoc:

  http://java.sun.com/j2ee/1.4/docs/api/index.html
  

Conventions

The following text conventions are used in this document.

Convention	Meaning
boldface	Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.
italic	Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.
monospace	Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.