Contents

Title and Copyright Information

Preface

• Documentation Accessibility
• Conventions

1 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
• WebLogic Server Value-Added JMS Features
  • Enterprise-Grade Reliability
  • Enterprise-Level Features
  • Performance
  • Tight Integration with WebLogic Server
  • Interoperability with Other Messaging Services
• New and Changed JMS Features
  • WebLogic Server 12.2.1 New and Changed Features

2 Understanding JMS Resource Configuration

• Overview of JMS and Oracle WebLogic Server
  • What Is the Java Message Service?
  • WebLogic JMS Architecture and Environment
  • Domain Configuration
• What are JMS Configuration Resources?
• Overview of JMS Servers
  • JMS Server Behavior in WebLogic Server 9.x and Later
• Overview of JMS Modules
  • JMS System Modules
  • JMS Application Modules (Deprecated)
  • Comparing JMS System Modules and Application Modules
  • Configurable JMS Resources in Modules
  • JMS Schema
  • JMS Interop Modules (Deprecated)
• Other Environment-Related System Resources for WebLogic JMS
  • Persistent Stores
  • JMS Store-and-Forward
  • Path Service
  • Messaging Bridges

3 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
    • Default Targeting
    • Advanced (Subdeployment) Targeting
• Specifying the Unmapped Resource Reference Mode for Connection Factories
• Connection Factory Configuration
  • Using the Default JMS Connection Factory Defined by Java EE 7
  • Using Default Connection Factories Defined by WebLogic Server
  • 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
• Message Limit in a Subscription
• Foreign Server Configuration
• Distributed Destination Configuration
• JMS Store-and-Forward (SAF) Configuration

4 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 of 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
    • Monitoring UDD Members
    • Configuring Partitioned Distributed Topics
      • Load Balancing Partitioned Distributed Topics
  • Creating Weighted Distributed Destinations
  • Load Balancing Messages Across a Distributed Destination
    • Load-Balancing Options
      • Round-Robin Distribution
      • Random Distribution
    • Consumer Load Balancing
    • Producer Load Balancing
    • Load-Balancing Heuristics
      • Transaction Affinity
      • Server Affinity
      • Queues with Zero Consumers
      • Paused Distributed Destination Members
    • Defeating Load Balancing
      • Connection Factories
    • Distributed Destination Load Balancing When Server Affinity Is Enabled
  • Distributed Destination Migration
  • Distributed Destination Failover
• Configure an Unrestricted ClientID
• Configure Shared Subscriptions

5 Simplified JMS Cluster and High Availability Configuration

• What Are the WebLogic Clustering Options for JMS?
• Understanding the Simplified JMS Cluster Configuration
• Using Persistent Stores with Cluster Targeted JMS Servers
• Targeting JMS Modules Resources
• Simplified JMS Configuration and High Availability Enhancements
  • Defining the Distribution Policy for JMS Services
  • Defining the Migration Policy for JMS Services
  • Additional Configuration Options for JMS Services
• Considerations and Limitations of Clustered JMS
  • Interoperability and Upgrade Considerations of Cluster Targeted JMS Servers
• Best Practices for Using Cluster Targeted JMS Services
• Runtime MBean Instance Naming Syntax
  • Instance Naming Syntax for .DAT File
  • Instance Naming Syntax for .RGN File
  • JDBC Store Table Name Syntax

6 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

7 Interoperating with Oracle AQ JMS

• Overview
• Using AQ Destinations as Foreign Destinations
• Driver Support
• Transaction Support
• Oracle Real Application Clusters
• MBean and Console Support
• Configuring WebLogic Server to Interoperate with AQ JMS
  • Configure Oracle AQ in the Database
    • Create Users and Grant Permissions
    • Create AQ Queue Tables
    • Create a JMS Queue or Topic
    • Start the JMS Queue or Topic
  • Configure WebLogic Server for AQ JMS
    • Configure a WebLogic Data Source for AQ JMS
      • Configuring a Generic Data Source for AQ JMS
      • Configuring an AGL Data Source for AQ JMS
      • Configuring a Generic Data Source for AQ JMS
      • Configuring an AGL Data Source for AQ JMS
    • Configure a JMS System Module
    • Configure a JMS Foreign Server
      • Reference a Data Source
    • Configure JMS Foreign Server Connection Factories
    • Configure AQ JMS Foreign Server Destinations
  • Additional Configuration for Interoperation with Oracle 12c Database
• Programming Considerations
  • Settings for Message Driven Beans to Interoperate with AQ JMS
  • Scalability for Clustered WebLogic MDBs Listening on AQ Topics
  • AQ JMS Extensions
    • Using AdtMessage
  • Resource References
  • JDBC Connection Utilization
  • Oracle RAC Support
  • Debugging
  • Performance Considerations
• Advanced Topics
  • Security Considerations
    • Configuring AQ Destination Security
    • Access to JNDI Advertised Destinations and Connection Factories
    • Controlling Access to Destinations that are Looked Up using the JMS API
      • Additional Security Configuration for Stand alone Clients
  • WebLogic Messaging Bridge
    • Create a Messaging Bridge Instance
  • Stand-alone WebLogic AQ JMS Clients
    • Configure a Foreign Server using the Database's JDBC URL
    • Limitations when using Stand-alone WebLogic AQ JMS Clients

8 Monitoring JMS Statistics and Managing Messages

• Monitoring JMS Statistics
  • Monitoring JMS Servers
    • Monitor Cluster Targeted 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

9 Best Practices for JMS Beginners and Advanced Users

• Configuration Best Practices
  • Configure JMS Servers and Persistent Stores
  • Configure JMS Quotas and Paging
  • Configure a JMS Module
  • Configure JMS Resources
  • Configure SAF Agents, Stores, and Imported Destination
• Targeting Best Practices
• High Availability Best Practices
  • Develop Applications on a Cluster
  • Leverage WebLogic HA Features
  • Ensure Your Data is Persisted Safely
• Client Resiliency Best Practices
• Distributed Destination Best Practices
  • Distributed Queues
  • Distributed Topics
  • Weighted Distributed Destinations
• Understanding WebLogic JMS Client Options
• Understanding WebLogic URLs
  • URL syntax
• Strict Message Ordering Best Practices
• Integrating Remote JMS Destinations
• JMS Performance and Tuning

10 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

A JMS Resource Definition Elements Reference

• Defining JMS Resources Using Java EE Resource Definitions
  • Resource Definitions Using Annotations
  • Resource Definitions in the Deployment Descriptor
  • Considerations and Best Practices for Using JMS Resource Definitions
• JMS Connection Factory Definition Elements and Properties
• JMS Destination Definition Elements and Properties

B Configuring JMS Application Modules for Deployment (Deprecated)

• 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
  • 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
  • About 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
• 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