Contents

Title and Copyright Information

Preface

• Documentation Accessibility
• Conventions

1 Introduction and Roadmap

• Document Scope and Audience
• Guide to This Document
• Related Documentation
• Samples and Tutorials for the System Administrator
• New and Changed SAF Features In This Release

2 Understanding the Store-and-Forward Service

• The WebLogic SAF Environment
  • The SAF Service
  • SAF Service Agents
    • SAF Agent Configuration Parameters
    • Persistent Store Rules When Targeting SAF Agents to a Cluster
  • Using SAF with WebLogic JMS
  • Using SAF With Web Services Reliable Messaging
  • SAF and Cross Domain Security
• When to Use the SAF Service
• Configuring a Basic SAF Service
• Designing SAF Agents
  • Setting a Message Time-To-Live Duration and Message Delivery Failure Policy
  • Logging Failed Message Deliveries
  • Setting Delivery Retry Attempts
  • Using Message Quotas, Thresholds, and Paging
  • Boot-Time Recovery
  • Migratable SAF Agents for Highly Available Messaging

3 Configuring SAF for JMS Messages

• SAF Resources In a JMS Module
  • Imported SAF Destinations
  • Remote SAF Context
  • SAF Error Handling
  • The SAF JMS Picture
• Creating JMS SAF Resources
• Main Steps to Configure SAF Resources for JMS Destinations
• Designing SAF for JMS Messages
  • Selecting a Quality-of-Service (QOS) Level
  • How SAF Handles Delivery Modes
  • Using Message Unit-of-Order
  • Transactional Messages
  • Message Compression Across SAF Boundaries
  • SAF to a Distributed Destination
  • SAF Load Balancing
    • Sending Messages to an Imported Destination
    • SAF Agent Forwarding Messages to a Remote Destination
  • Using the JMSReplyTo Field with SAF
  • Securing SAF Destinations
  • Connections and ConnectionFactories

4 Monitoring and Managing SAF Agents

• Monitoring SAF Agents
• Managing Message Operations on SAF Agents

5 Troubleshooting WebLogic SAF

• Debugging WebLogic SAF
  • 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
  • SAF Debugging Scopes
  • Request Dyeing
• SAF Message Life Cycle Logging for JMS Messages
  • Events in the SAF Message Life Cycle
    • Message Log Location
  • Enabling SAF Message Logging
  • SAF Message Log Content
    • SAF Message Log Record Format
  • Sample Log File Records
    • Message Stored Event
    • Message Forwarded Event
    • Message Expired Event
    • Message Removed Event
  • Managing SAF Agent Log Files
    • Rotating Message Log Files
    • Renaming Message Log Files
    • Limiting the Number of Retained Message Log Files
• Frequently Asked Questions About JMS SAF