1 Introduction and Roadmap

This documentation describes the contents and organization of this guide—Administering the JMS Resource Adapter for Oracle WebLogic Server.

It includes the following topics:

Document Scope and Audience

This document is a resource for system administrators who use WebLogic JMS in a foreign application server and want to interoperate using a Java EE Connector Architecture resource adapter that integrates a WebLogic JMS client.

It is assumed that the reader is familiar with programming in Java Platform, Enterprise Edition (Java EE), Java EE Connector Architecture version 1.7 resource adapters, and JMS concepts. This document emphasizes the value-added features provided by WebLogic Server and key information about how to configure and use the WebLogic JMS resource adapter.

Guide to This Document

This chapter, Introduction and Roadmap describes the organization and scope of this guide, including new features and related documentation.
Understanding the WebLogic JMS Resource Adapter provides an overview of WebLogic JMS resource adapter components, concepts, and functionality.
Administering the JMS Resource Adapter on Oracle GlassFish Server explains the components, design options, and other prerequisite considerations needed to use the JMS resource adapter to interoperate using WebLogic JMS in a foreign application server.
Administering the JMS Resource Adapter on Oracle GlassFish Server describes additional configuration information and considerations when using deploying the JMS resource adapter on the .
Understanding Message Consumption describes how to configure the deployment descriptor file, ra.xml, for a JMS resource adapter to have message-driven beans (MDBs) asynchronously consume WebLogic JMS messages in a foreign application server as inbound messages.
Sending Outbound JMS Messages describes how to send JMS messages using the JMS resource adapter.
Configuring Destinations and Naming Contexts provides information on configuring adminobject elements to define destinations and naming contexts for inbound and outbound communication.
Understanding Resource Providers describes how to use and configure Resource Providers. A resource provider defines the JNDI properties that allow the JMS resource adapter to connect to the WebLogic JMS provider.
Understanding Transaction Processing describes transaction processing and recovery when using the JMS resource adapter to interoperate between a foreign application server and WebLogic Server.
Understanding Failure Management describes how the JMS resource adapter responds to WebLogic Server and foreign application server failures.
Securing JMS Resource Adapter Connections describes security considerations for the JMS resource adapter.
JMS Resource Adapter Deployment Descriptor Elements and Properties provides information about the WebLogic JMS resource adapter deployment descriptor file, ra.xml.

Samples and Tutorials for the JMS Developer

In addition to this document, Oracle provides a variety of code samples and tutorials for JMS developers. The examples and tutorials illustrate WebLogic Server JMS in action, and provide practical instructions on how to perform key JMS development tasks.

Oracle recommends that you run some or all of the JMS examples before developing your own JMS applications.

JMS Resource Adapter Example

This example demonstrates how to utilize the WebLogic JMS resource adapter deployed on a foreign application server to interoperate with the WebLogic JMS service. This example is included when you install the examples in your WebLogic distribution.

For details about the JMS Resource Adapter example, see JMS Resource Adapter Example.

Avitek Medical Records Application (MedRec) and Tutorials

MedRec is an end-to-end sample Java EE application shipped with WebLogic Server that simulates an independent, centralized medical record management system. The MedRec application provides a framework for patients, doctors, and administrators to manage patient data using a variety of different clients.

MedRec demonstrates WebLogic Server and Java EE features, and highlights Oracle-recommended best practices. MedRec is optionally installed with the WebLogic Server installation. You can start MedRec from the ORACLE_HOME\user_projects\domains\medrec directory, where ORACLE_HOME is the directory you specified as the Oracle Home when you installed Oracle WebLogic Server.

See Sample Applications and Code Examples in Understanding Oracle WebLogic Server for information about installing and configuring the suite of sample applications.

MedRec includes a service tier composed primarily of Enterprise Java Beans (EJBs) that work to process requests from web applications, web services, workflow applications, and client applications. MedRec includes message-driven, stateless session, stateful session, and entity EJBs.

JMS Examples in the WebLogic Server Distribution

WebLogic Server optionally installs API code examples in WL_HOME\samples\server\examples\src\examples, where WL_HOME is the top-level directory of your WebLogic Server installation. Start the examples server and obtain information about the samples and how to run them from the WebLogic Server Start menu.

Additional JMS Examples Available for Download

Additional API examples are available for download at the Oracle Technology Network at http://www.oracle.com/technology/index.html. These examples are distributed as.zip files that you unzip into an existing WebLogic Server samples directory structure. You build and run the downloadable examples in the same manner as you would an installed WebLogic Server example.

New and Changed Features in This Release

See What's New in Oracle WebLogic Server 12.2.1.2.0 for a comprehensive listing of the new WebLogic Server features introduced in this release.