Configure WebLogic JMS
Introduction and Roadmap
Document Scope and Audience
Guide to This Document
Related Documentation
JMS Samples and Tutorials for the JMS Administrator
Avitek Medical Records Application (MedRec) and Tutorials
JMS Examples in the WebLogic Server Distribution
New and Changed JMS Features In This Release
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
JMS Store-and-Forward (SAF)
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
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 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
How JMS Clustering Works
JMS Clustering Naming Requirements
Distributed Destination Within a Cluster
JMS Services As a Migratable Service Within a Cluster
Configuration Guidelines for JMS Clustering
What About Failover?
Migration of JMS-related Services
Automatic Migration of JMS Services
Manual Migration JMS Services
Persistent Store High Availability
Using the WebLogic Path Service
Path Service High Availability
Implementing Message UOO With a 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
Creating Weighted Distributed Destinations
Load Balancing Messages Across a Distributed Destination
Paused Distributed Destination Members
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 Java EE 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
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
Generating Unique Runtime JNDI Names for JMS Resources
Unique Runtime JNDI Name for Local Applications
Unique Runtime JNDI Name for Application Libraries
Unique Runtime JNDI Name for Standalone JMS Modules
Where to Use the ${APPNAME} String
Example Use-Case
Using WLST to Manage JMS Servers and JMS System Module Resources
Understanding JMS System Modules and Subdeployments
How to Create JMS Servers and JMS System Module Resources
How to Modify and Monitor JMS Servers and JMS System Module Resources
Best Practices when Using WLST to Configure JMS Resources
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
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
Enabling JMS Message Logging
JMS Message Log Content
JMS Message Log Record Format
Sample Log File Records
Managing JMS Server Log Files
Limiting the Number of Retained Message Log Files
Controlling Message Operations on Destinations
Definition of Message Production, Insertion, and Consumption
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