Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Structure

Related Documents

Conventions

1 Introduction

What is the Oracle Message Broker?

What is JMS?

Oracle Message Broker Components

Oracle Message Broker Core

Drivers and Message Servers

Administrative Components

Client Programming Interface

Oracle Message Broker Features

Administration and Monitoring Utilities

Command Line Tools

Graphical User Interface

Performance Monitoring Service

Oracle Message Broker Deployment Options

Configuration Options

Operation Modes

2 Quick Start

Working with the Administration Utilities

Overview of the Sample Administration Scripts

Using the Oracle Message Broker Instance Configuration Script

Using the Driver Configuration Scripts

Using the Propagation Configuration Script

Verifying Directory Contents

Starting and Stopping the Oracle Message Broker

The msg_broker Entry and Distinguished Names

Required Environment Variables

Stopping the Oracle Message Broker

Checking the Status of the Oracle Message Broker

Running Oracle Message Broker as an NT Service

Running the JMS Sample Programs

3 JMS Programming

Deployment Options for an Oracle Message Broker Application

Programming Roadmap (Using an LDAP Directory)

Accessing Objects in the Directory

Accessing Objects for Point-to-Point Messaging

Accessing Objects for Publish/Subscribe Messaging

Point-to-Point Messaging

Creating and Starting a Queue Connection

Getting a Queue Session

Working with Queue Destinations - QueueSender and QueueReceiver

Sending and Receiving Messages

Shutting Down

Publish/Subscribe Messaging

Creating and Starting a Topic Connection

Getting a Topic Session

Working with Topic Destinations - TopicPublisher and TopicSubscriber

Publishing and Subscribing

Subscribing to Topics

Shutting Down (Publish/Subscribe)

Message Listeners and Threads

Closing JMS Objects and Death Detection

Leaked Resources and Death Detection

Setting the Message Priority

4 Administration

What is the Oracle Internet Directory?

What is a Directory?

What is LDAP?

Directory Entries

Attributes

Object Classes

Schemas

Accessing LDAP with the Administrative Framework

Oracle Message Broker Directory Information Tree

Oracle Message Broker Configuration

Oracle Message Broker Configuration Roadmap

Reserved Internal Attributes

Creating an Oracle Message Broker Instance

Creating and Configuring Message Servers

Configuring the Message Broker Entry and Drivers

Creating and Configuring Connection Factories

Adding Queues

Adding Topics

Creating and Configuring Remote Directories

Creating and Configuring Remote HTTP Listeners

Creating and Configuring Propagation Jobs

Creating and Configuring Durable Subscribers

Creating and Configuring Asynchronous Component Invocation Triggers

Showing Directory Attributes and Entries

Dynamic Configuration

Create Entry Restrictions

Update Entry Restrictions

Delete Entry Restrictions

Command-line Administration Utility - AdminUtil

Object References

Entry Attributes

AdminUtil Limitations

Directory Utilities

Checking Directory Entries with AdminDirCheck

Migrating Directory Entries Between Releases

5 Oracle Message Broker Features

Working With JMS Messages

Message Properties

Using Message Selectors

Using a QueueBrowser

Using Durable Subscribers

Using the PL/SQL Operational Interface

Running in Local Mode

Using Local Mode with an LDAP Directory

Using Local Mode with Lightweight Configuration

Local Mode Limitations

Sample Local and Remote Mode Client Programs

Running in Remote Mode

Starting Oracle Message Broker in Remote Mode

Starting Oracle Message Broker Clients in Remote Mode

Remote Mode Limitations

Oracle Message Broker Version Checking

6 Oracle Message Broker Extensions

Using XML Messages

Sending and Receiving XML Messages

The XML_to_JMS Method

The JMS_to_XML Method

Collecting Runtime Metrics

Using DMS

DMS Format Options - Standard and Pretty

AQ Driver Runtime Metrics

Creating Destinations

Defining Destination Strings

Using Client-Side Callouts

Defining Callout Methods

Using Callouts in a Message Producer

Using Callouts in a Message Consumer

Using Properties to Indicate Callouts

Sample Client Side Callout Programs

Universal Connections and Universal Sessions

Receiving with a Message ID

Using AQ Rules for Message Selection

Creating AQ Rules Based Message Selectors

PL/SQL Functions Supporting AQ Rules

Obtaining the JDBC Connection in Local Mode

Sample Code Using a JDBC Connection

7 Message Servers and Drivers

Driver Configuration

Driver Features Summary

Oracle Advanced Queuing Driver

AQ Driver Connection Types

AQ Messages

JDBC Mode

OCI Mode

AQ Message Persistence

AQ User Identities

AQ Tuning and Configuration

AQ Failure Recovery

AQ Driver Restrictions

Oracle AQ Lite Driver

AQ Lite Message Persistence

AQ Lite Message Mapping

AQ Lite Driver Propagation

Oracle Volatile Driver

IBM MQSeries Driver

MQSeries Message Mapping

Connections to MQSeries Queue Managers

Transaction Support

Multiple Queue Manager Support

MQSeries Driver Configuration

MQSeries Driver Limitations

Oracle Multicast Driver

Understanding Multicast Driver Operation

Distributed Topics

Messages

Multicast Server Configuration

MultiCast Driver Limitations

TIB/Rendezvous Driver

Distributed Topics

Messages

Sessions

TIB/Rendezvous Installation and Administration

TIB/Rendezvous Driver Limitations

8 Oracle Message Broker Propagation

Overview of Oracle Message Broker Propagation

Types of Propagation

Propagation with Message Selectors

Propagation Transport Protocols

IIOP Propagation

HTTP Propagation

Administration and Configuration

Sending Broker Configuration

Receiving Broker Configuration

Propagation Job Configuration

HTTP Propagation Servlet Configuration

Propagation Security

IIOP propagation Security

HTTP Propagation Security

Propagation Control

Creating and Deleting Propagation Jobs

Activating and Deactivating a Propagation Jobs

Error Handling and Recovery

Propagation Limitations

9 Oracle Message Broker C++ API

Introduction

System Requirements

Limitations

Major Differences between the Java and C++ APIs

Declaration

Types

Memory Management

Sample Application

General Declarations

Initialization

Sending Messages (Sender Specific)

Receiving Messages (Receiver Specific)

Cleanup

10 Logging and Troubleshooting

Working with Log Files

Logging Directory

DMS Metric Log Files

Logging Security Exceptions

Problems and Common Solutions

MQ Series Driver Problems

Runtime Exceptions

11 Administration GUI

Terminology

Starting Oracle Message Broker Manager

Connecting to a Directory Server

Navigating Oracle Message Broker Manager

Oracle Message Broker Manager Menu Bar

Oracle Message Broker Manager Toolbar

Disconnecting from a Directory Server

Performing Administration Tasks

Viewing Entries

Adding Entries

Deleting Entries

Modifying Entries

Using the Configuration Wizards to Add Entries

12 Security

Features and Assumptions

SSL Overview

Programming and Administration Control and Assumptions

Security Components

LDAP Server Security

Oracle Message Broker Security

Provider Security

Security Priority

Network Security Overview

Supported Cipher Suites

LDAP Directory Server Security Administration

Creating LDAP Users and Working with Access Control Lists

Enabling SSL and Authentication for the LDAP Directory

Configuring SSL for OiD

OiD Access Control and Authorization

Creating users and groups in OiD

Oracle Message Broker Security Administration

Oracle Message Broker SSL Options

Enabling Propagation Security

Using the Oracle Message Broker Security Service

Provider Security Administration

Client Connections to the Oracle Message Broker using Authentication

13 Lightweight Configuration

Benefits of Lightweight Configuration

Using Lightweight Configuration

Configuration Changes

Starting with Lightweight Configuration in Remote Mode

Starting with Lightweight Configuration in Local Mode

Deploying Using Lightweight Configuration

Specifying Configuration Values with Lightweight Configuration

Lightweight Configuration Properties

Subscriber Configuration Properties

Driver Properties

Destination Properties

Sample Configuration Files

Lightweight Configuration Constraints and Limitations

14 Asynchronous Component Invocation

ACI Architecture

ACI Listener

ACI Dispatcher

ACI Adapters

ACI Helper Classes

ACI Triggers

Setting the ACI Threshold Parameter

Setting the ACI Concurrency Parameter

EJB Adapter

Notification-driven Beans

Message-driven Beans

Java Helper Classes

ACI Tutorial

Configure Oracle Database

Define a Remote Interface

Define a Home Interface

Implement the EJB

Compile and Generate Jar File

Deploy the EJB

Add a Trigger Entry to Oracle Message Broker

A Oracle AQ Driver ADTs

JMS ADT Types

Type ombaq_property

Type ombaq_properties

Type ombaq_header

Type ombaq_text_msg

Type ombaq_bytes_msg

Type ombaq_object_msg Fields

Type ombaq_stream_element Fields

Type ombaq_stream_elements

Type ombaq_stream_msg

Type ombaq_map_element

Type ombaq_map_elements

Type ombaq_map_msg

Type ombaq_serial_msg

PL/SQL Package Interface

PL/SQL Package Limitations

Coercion and Invalid Data

Sample Usage from PL/SQL

Index