Contents

List of Figures

List of Tables

List of Procedures

Preface

Audience for This Guide
Organization of This Guide
Conventions

Text Conventions
Directory Variable Conventions

Other Documentation Resources

The MQ Documentation Set
Online Help
JavaDoc
Example Client Applications
The Java Message Service (JMS) Specification

Chapter 1 Overview

What Is Sun ONE Message Queue?
Product Editions

Platform Edition
Enterprise Edition

Enterprise Messaging Systems

Requirements of Enterprise Messaging Systems
Centralized vs. Peer to Peer Messaging
Messaging System Concepts

Message
Message Service Architecture
Message Delivery Models

The JMS Specification

JMS Message Structure
JMS Programming Model
Administered Objects

JMS/J2EE Programming: Message-driven Beans

Message-driven Beans
Application Server Support

JMS Messaging Issues

JMS Provider Independence
Programming Domains
Client Identifiers
Reliable Messaging

Acknowledgements/Transactions
Persistent Storage

Performance Trade-offs
Message Selection
Message Order and Priority

Chapter 2 The MQ Messaging System

MQ Message Server

Broker

Connection Services
Message Router
Persistence Manager
Security Manager
Logger

Physical Destinations

Queue Destinations
Topic Destinations
Auto-Created (vs. Admin-Created) Destinations
Temporary Destinations

Multi-Broker Clusters (Enterprise Edition)

Multi-Broker Architecture
Using Clusters in Development Environments
Cluster Configuration Properties

MQ Client Runtime

Message Production
Message Consumption

MQ Administered Objects

Connection Factory Administered Objects
Destination Administered Objects
Overriding Attribute Values at Client Startup

Chapter 3 MQ Administration

MQ Administration Tasks

Development Environments
Production Environments

Setup Operations
Maintenance Operations

MQ Administration Tools

The Administration Console
Summary of Command Line Utilities

Command Line Syntax
Common Command Line Options

Chapter 4 Administration Console Tutorial

Getting Ready
Starting the Administration Console

Getting Help

Working With Brokers

Starting a Broker
Adding a Broker
Changing the Administrator Password
Connecting to the Broker
Viewing Connection Services
Adding Physical Destinations to a Broker
Working With Physical Destinations
Getting Information About Topic Destinations

Working with Object Stores

Adding an Object Store
Checking Object Store Properties
Connecting to an Object Store
Adding a Connection Factory Administered Object
Adding a Destination Administered Object
Administered Object Properties

Updating Console Information
Running the Sample Application

Chapter 5 Starting and Configuring a Broker

Configuration Files

Merging Property Values
Property Naming Syntax
Editing the Instance Configuration File

Starting a Broker
Working With Clusters (Enterprise Edition)

Cluster Configuration Properties
Connecting Brokers

Method 1: No Cluster Configuration File
Method 2: Using a Cluster Configuration File

Adding Brokers to Clusters
Restarting a Broker in a Cluster
Removing a Broker from a Cluster
Backing up the Master Broker's Configuration Change Record
Restoring the Master Broker's Configuration Change Record

Logging

Default Logging Configuration
Log Message Format
Changing the Logger Configuration

Changing the Output Channel
Changing Rollover Criteria
Logging Broker Performance Metrics

Chapter 6 Broker and Application Management

Command Utility

Syntax of Command
imqcmd Subcommands
Summary of imqcmd Options
Prerequisites to Using imqcmd
Examples

Controlling the Broker's State
Querying and Updating Broker Properties

Querying a Broker
Updating a Broker

Managing Connection Services

Listing Connection Services
Querying and Updating Service Properties
Pausing and Resuming a Service

Managing Destinations

Creating Destinations
Getting Information About Destinations
Updating Destinations
Purging Destinations
Destroying Destinations

Managing Durable Subscriptions
Managing Transactions

Chapter 7 Managing Administered Objects

About Object Stores
Administered Objects
Object Manager Utility (imqobjmgr)

Syntax of Command
imqobjmgr Subcommands
Summary of imqobjmgr Command Options
Required Information
Administered Object Attributes

Connection Factory Administered Objects
Destination Administered Objects

Object Store Attributes

Initial Context and Location Information
Security Information (LDAP Only)

Using Input Files

Adding and Deleting Administered Objects

Adding a Connection Factory
Adding a Topic or Queue
Deleting Administered Objects

Getting Information

Listing Administered Objects
Information About a Single Object

Updating Administered Objects

Chapter 8 Security Management

Authenticating Users

Using a Flat-File User Repository

User Manager Utility (imqusermgr)
Groups
States
Format of User Names and Passwords
Populating and Managing the User Repository
Changing the Default Administrator Password

Using an LDAP Server for a User Repository

Authorizing Users: the Access Control Properties File

Access Rules Syntax
Permission Computation
Connection Access Control
Destination Access Control
Destination Auto-Create Access Control

Encryption: Working With an SSL Service (Enterprise Edition)

Setting Up an SSL Service Over TCP/IP

Step 1. Generating a Self-Signed Certificate
Step 2. Enabling the SSL-based Service in the Broker
Step 3. Starting the Broker
Step 4. Configuring and Running SSL-based Clients

Setting Up an SSL Service Over HTTP

Using a Passfile

Appendix A Setting Up Plugged-in Persistence

Introduction
Plugging In a JDBC-accessible Data Store
JDBC-related Broker Configuration Properties
Database Manager Utility (imqdbmgr)

Syntax of Command
imqdbmgr Subcommands
Summary of imqdbmgr Command Options

Appendix B HTTP/HTTPS Support (Enterprise Edition)

HTTP/HTTPS Support Architecture
Implementing HTTP Support

Step 1. Deploying the HTTP Tunnel Servlet on a Web Server

Deploying as a Jar File
Deploying as a Web Archive File

Step 2. Configuring the httpjms Connection Service
Step 3. Configuring an HTTP Connection

Setting Connection Factory Attributes
Using a Single Servlet to Access Multiple Brokers
Using an HTTP Proxy

Example: Deploying the HTTP Tunnel Servlet

Deploying as a Jar File
Deploying as a WAR File

Implementing HTTPS Support

Step 1. Generating a Self-signed Certificate for the HTTPS Tunnel Servlet
Step 2. Deploying the HTTPS Tunnel Servlet on a Web Server

Deploying as a Jar File
Deploying as a Web Archive File

Step 3. Configuring the httpsjms Connection Service
Step 4. Configuring an HTTPS Connection

Configuring JSSE
Importing a Root Certificate
Setting Connection Factory Attributes
Using a Single Servlet to Access Multiple Brokers
Using an HTTP Proxy

Example: Deploying the HTTPS Tunnel Servlet

Deploying as a Jar File
Deploying as a WAR File

Appendix C Using a Broker as a Windows Service

Running a Broker as a Windows Service
Service Administrator Utility (imqsvcadmin)

Syntax of Command
imqsvcadmin Subcommands
Summary of imqsvcadmin Options
Removing the Broker Service
Reconfiguring the Broker Service
Using an Alternate Java Runtime
Querying the Broker Service
Troubleshooting

Appendix D Location of MQ Data

Appendix E Stability of MQ Interfaces

Glossary

Index