Skip navigation.
Downloads | Product Documentation | Support

Programming WebLogic JMS

# Introduction and Roadmap

This section describes the contents and organization of this guide—Programming WebLogic JMS.

- Document Scope and Audience
- Guide to this Document
- Related Documentation
- Samples and Tutorials for the JMS Developer
- New and Changed JMS Features In This Release

# Document Scope and Audience

This document is a resource for software developers who want to develop and configure applications that include WebLogic Server Java Message Service (JMS). It also contains information that is useful for business analysts and system architects who are evaluating WebLogic Server or considering the use of WebLogic Server JMS for a particular application

The topics in this document are relevant during the design and development phases of a software project. The document also includes topics that are useful in solving application problems that are discovered during test and pre-production phases of a project.

This document does not address production phase administration, monitoring, or performance tuning JMS topics. For links to WebLogic Server documentation and resources for these topics, see Related Documentation.

It is assumed that the reader is familiar with J2EE and JMS concepts. This document emphasizes the value-added features provided by WebLogic Server JMS and key information about how to use WebLogic Server features and facilities to get a JMS application up and running.

# Guide to this Document

- This chapter, Introduction and Roadmap, introduces the organization of this guide.
- Understanding WebLogic JMS, provides an overview of the Java Message Service. It also describes WebLogic JMS components and features.
- Best Practices for Application Design, provides design options for WebLogic Server JMS, application behaviors to consider during the design process, and recommended design patterns.
- Developing a Basic JMS Application, describes how to develop a WebLogic JMS application.
- Managing Your Applications, describes how to programatically manage your JMS applications using value-added WebLogic JMS features.
- Using JMS Module Helper to Manage Applications, describes how to programatically create and manage JMS servers, Store-and-Forward Agents, and JMS system resources.
- Using Multicasting with WebLogic Server, describes how to use Multicasting to enable the delivery of messages to a select group of hosts that subsequently forward the messages to subscribers.
- Using Distributed Destinations, describes how to use distributed destinations with WebLogic JMS.
- Enhanced J2EE Support for Using WebLogic JMS With EJBs and Servlets, describes "best practice" methods that make it easier to use WebLogic JMS in conjunction with J2EE components, like Enterprise Java Beans and Servlets.
- Using Message Unit-of-Order, describes how to use Message Unit-of-Order to provide strict message ordering when using WebLogic JMS queues.
- Using Transactions with WebLogic JMS, describes how to use transactions with WebLogic JMS.
- WebLogic JMS C API, provides information on how to develop C programs that interoperate with WebLogic JMS.
- Recovering from a WebLogic Server Failure, describes how to terminate a JMS application gracefully if a server fails and how to migrate JMS data after server failure.
- Deprecated WebLogic JMS Features, describes features that have been deprecated for this release of WebLogic Server:

# Related Documentation

This document contains JMS-specific design and development information.

For comprehensive guidelines for developing, deploying, and monitoring WebLogic Server applications, see the following documents:

- Configuring and Managing WebLogic JMS for information about configuring and managing JMS resources.
- Configuring and Managing WebLogic Store-and-Forward for information about the benefits and usage of the Store-and-Forward service with WebLogic JMS.
- Using the WebLogic Persistent Store for information about the benefits and usage of the system-wide WebLogic Persistent Store.
- Deploying Applications to WebLogic Server is the primary source of information about deploying WebLogic Server applications.

# Samples and Tutorials for the JMS Developer

In addition to this document, BEA Systems 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.

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

## Avitek Medical Records Application (MedRec) and Tutorials

MedRec is an end-to-end sample J2EE 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 J2EE features, and highlights BEA-recommended best practices. MedRec is included in the WebLogic Server distribution, and can be accessed from the Start menu on Windows machines. For Linux and other platforms, you can start MedRec from the WL_HOME`\samples\domains\medrec` directory, where WL_HOME is the top-level installation directory for WebLogic Platform.

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

## JMS Examples in the WebLogic Server Distribution

WebLogic Server 9.1 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. You can start the examples server, and obtain information about the samples and how to run them from the WebLogic Server 9.1 Start menu.

Additional API examples for download at http://codesamples.projects.dev2dev.bea.com. These examples are distributed as ZIP files that you can 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. See the download pages of individual examples for more information at `https://codesample.projects.dev2dev.bea.com`.

# New and Changed JMS Features In This Release

For a comprehensive listing of the new WebLogic JMS feature introduced in release 9.1, see New and Changed JMS Features In This Release in Configuring and Managing WebLogic JMS.