Configuring and Managing WebLogic JMS

Introduction and Roadmap

Document Scope and Audience

Guide to This Document

JMS Samples and Tutorials for the JMS Administrator

Avitek Medical Records Application (MedRec) and Tutorials

JMS Examples in the WebLogic Server Distribution

Additional JMS Examples Available for Download

New and Changed JMS Features In This Release

Simplified Configuration and Targeting of JMS System Resources

Message Life Cycle Logging for JMS SAF Destinations

Enhanced Run-time Management for Durable Topic Subscribers and Distributed Queues

Automatic JMS Client Failover

Performance Improvements

Message Prefetching Available for Synchronous Message Consumers

Improved Tuning of Message Latency or Throughput on Destinations

Deprecated JMS Methods and Interfaces

WebLogic Server Value-Added JMS Features

Enterprise-Grade Reliability

Enterprise-Level Features

Performance

Tight Integration With WebLogic Server

Interoperability With Other Messaging Services

Understanding JMS Resource Configuration

Overview of JMS and WebLogic Server

What Is the Java Message Service?

WebLogic JMS Architecture and Environment

Domain Configuration: Environment-Related Resources versus Application-Related Resources

What Are JMS Configuration Resources?

Overview of JMS Servers

JMS Server Behavior in WebLogic Server 9.0 and Later

Overview of JMS Modules

JMS System Modules

JMS Application Modules

Comparing JMS System Modules and Application Modules

Configurable JMS Resources in Modules

JMS Schema

JMS Interop Modules

Other Environment-Related System Resources for WebLogic JMS

Persistent Stores

Store-and-Forward (SAF) Service

Path Service

Messaging Bridges

Configuring Basic JMS System Resources

Methods for Configuring JMS System Resources

Main Steps for Configuring Basic JMS System Resources

Advanced Resources in JMS System Modules

JMS Configuration Naming Requirements

JMS Server Configuration

JMS Server Configuration Parameters

JMS Server Targeting

JMS Server Monitoring Parameters

Session Pools and Connection Consumers

JMS System Module Configuration

JMS System Module and Resource Subdeployment Targeting

Basic System Assisted Targeting

Advanced Subdeployment Targeting

Connection Factory Configuration

Using a Default Connection Factory

Connection Factory Configuration Parameters

Connection Factory Targeting

Queue and Topic Destination Configuration

Queue and Topic Configuration Parameters

Creating Error Destinations

Creating Distributed Destinations

Queue and Topic Targeting

Destination Monitoring and Management Parameters

JMS Template Configuration

JMS Template Configuration Parameters

Destination Key Configuration

Quota Configuration

Foreign Server Configuration

Distributed Destination Configuration

JMS Store-and-Forward (SAF) Configuration

Configuring Advanced JMS System Resources

Configuring WebLogic JMS Clustering

Advantages of JMS Clustering

Obtain a Clustered JMS Licence

How JMS Clustering Works

JMS Clustering Naming Requirements

Distributed Destination Within a Cluster

JMS As a Migratable Service Within a Cluster

Configuration Guidelines for JMS Clustering

What About Failover?

Configuring Migratable Targets for JMS Servers

Configuration Steps for JMS Service Migration

Persistent Store High Availability

Using the WebLogic Path Service

Configuring Foreign Server Resources to Access Third-Party JMS Providers

How WebLogic JMS Accesses Foreign JMS Providers

Creating Foreign Server Resources

Creating Foreign Connection Factory Resources

Creating a Foreign Destination Resources

Sample Configuration for MQSeries JNDI

Configuring Distributed Destination Resources

Uniform Distributed Destinations vs. Weighted Distributed Destinations

Creating Uniform Distributed Destinations

Targeting Uniform Distributed Queues and Topics

Pausing and Resuming Message Operations on UDD Members

Monitoring UDD Members

Creating Weighted Distributed Destinations

Load Balancing Messages Across a Distributed Destination

Load Balancing Options

Consumer Load Balancing

Producer Load Balancing

Load Balancing Heuristics

Defeating Load Balancing

How Distributed Destination Load Balancing Is Affected When Server Affinity Is Enabled

Distributed Destination Migration

Distributed Destination Failover

Configuring JMS Application Modules for Deployment

Methods for Configuring JMS Application Modules

JMS Schema

Packaging JMS Application Modules In an Enterprise Application

Creating Packaged JMS Application Modules

Packaged JMS Application Module Requirements

Main Steps for Creating Packaged JMS Application Modules

Referencing a Packaged JMS Application Module In Deployment Descriptor Files

Referencing JMS Application Modules In a weblogic-application.xml Descriptor

Referencing JMS Resources In a WebLogic Application

Referencing JMS Resources In a J2EE Application

Sample of a Packaged JMS Application Module In an EJB Application

Packaged JMS Application Module References In weblogic-application.xml

Packaged JMS Application Module References In ejb-jar.xml

Packaged JMS Application Module References In weblogic-ejb-jar.xml

Packaging an Enterprise Application With a JMS Application Module

Deploying a Packaged JMS Application Module

Deploying Standalone JMS Application Modules

Standalone JMS Modules

Creating Standalone JMS Application Modules

Standalone JMS Application Module Requirements

Main Steps for Creating Standalone JMS Application Modules

Sample of a Simple Standalone JMS Application Module

Deploying Standalone JMS Application Modules

Tuning Standalone JMS Application Modules

Using WLST to Manage JMS Servers and JMS System Resources

Understanding System Modules and Subdeployments

How to Create JMS Servers and System Resources

How to Modify and Monitor JMS Servers and JMS Resources

Best Practices when Using WLST to Configure JMS

Monitoring JMS Statistics and Managing Messages

Monitoring JMS Statistics

Monitoring JMS Servers

Monitoring Active JMS Destinations

Monitoring Active JMS Transactions

Monitoring Active JMS Connections, Sessions, Consumers, and Producers

Monitoring Active JMS Session Pools

Monitoring Queues

Monitoring Topics

Monitoring Durable Subscribers for Topics

Monitoring Uniform Distributed Queues

Monitoring Uniform Distributed Topics

Monitoring Pooled JMS Connections

Managing JMS Messages

JMS Message Management Using Java APIs

JMS Message Management Using the Administration Console

Monitoring Message Runtime Information

Querying Messages

Moving Messages

Deleting Messages

Creating New Messages

Importing Messages

Exporting Messages

Managing Transactions

Managing Durable Topic Subscribers

Troubleshooting WebLogic JMS

Configuring Notifications for JMS

Debugging JMS

Enabling Debugging

Enable Debugging Using the Command Line

Enable Debugging Using the WebLogic Server Administration Console

Enable Debugging Using the WebLogic Scripting Tool

Changes to the config.xml File

JMS Debugging Scopes

Messaging Kernel and Path Service Debugging Scopes

Request Dyeing

Message Life Cycle Logging

Events in the JMS Message Life Cycle

Message Log Location

Enabling JMS Message Logging

JMS Message Log Content

JMS Message Log Record Format

Sample Log File Records

Consumer Created Event

Consumer Destroyed Event

Message Produced Event

Message Consumed Event

Message Expired Event

Retry Exceeded Event

Message Removed Event

Managing JMS Server Log Files

Rotating Message Log Files

Renaming Message Log Files

Limiting the Number of Retained Message Log Files

Controlling Message Operations on Destinations

Definition of Message Production, Insertion, and Consumption

Pause and Resume Logging

Production Pause and Production Resume

Pausing and Resuming Production at Boot-time

Pausing and Resuming Production at Runtime

Production Pause and Resume and Distributed Destinations

Production Pause and Resume and JMS Connection Stop/Start

Insertion Pause and Insertion Resume

Pausing and Resuming Insertion at Boot Time

Pausing and Resuming Insertion at Runtime

Insertion Pause and Resume and Distributed Destination

Insertion Pause and Resume and JMS Connection Stop/Start

Consumption Pause and Consumption Resume

Pausing and Resuming Consumption at Boot-time

Pausing and Resuming Consumption at Runtime

Consumption Pause and Resume and Queue Browsers

Consumption Pause and Resume and Distributed Destination

Consumption Pause and Resume and Message-Driven Beans

Consumption Pause and Resume and JMS Connection Stop/Start

Definition of In-Flight Work

In-flight Work Associated with Producers

In-flight Work Associated with Consumers

Order of Precedence for Boot-time Pause and Resume of Message Operations

Security

Tuning WebLogic JMS

Tuning Destination Performance

Defining Quotas for Destinations

Quota Resources

Destination-Level Quotas

JMS Server-Level Quota

Specifying a Blocking Send Policy on JMS Servers

Defining a Send Timeout on Connection Factories

Compressing Messages

Paging Out Messages To Free Up Memory

Specifying a Message Paging Directory

Tuning the Message Buffer Size Option

Controlling the Flow of Messages on JMS Servers and Destinations

How Flow Control Works

Configuring Flow Control

Flow Control Thresholds

Handling Expired Messages

Defining a Message Expiration Policy

Configuring an Expiration Policy on Topics

Configuring an Expiration Policy on Queues

Configuring an Expiration Policy on Templates

Defining an Expiration Logging Policy

Enabling Active Message Expiration

Configuring a JMS Server to Actively Scan Destinations for Expired Messages