Sun Java System Message Queue 3.5 SP1 Administration Guide |
Preface
This book, the Sun Java System Message Queue 3.5 SP1 Administration Guide, provides the background and information needed to perform administration tasks for a Message Queue messaging system.
This preface contains the following sections:
Audience for This GuideThis guide is meant for administrators as well as application developers who need to perform Message Queue administration tasks.
A Message Queue administrator is responsible for setting up and managing a Message Queue messaging system, in particular the Message Queue message server at the heart of this system. The book does not assume any knowledge or understanding of messaging systems.
The guide is also meant to be used by application developers to better understand how to optimize their applications to make best use of the features and flexibility of the Message Queue messaging system.
Organization of This GuideThis guide is designed to be read from beginning to end. The following table briefly describes the contents of each chapter:
Table 1 Book Contents
Chapter
Description
Presents a high-level conceptual overview of Message Queue messaging systems and terminology.
Describes the Message Queue messaging system, with special emphasis on the Message Queue broker and the Message Queue client runtime that together provide messaging services.
Describes Message Queue administration tasks and tools, and introduces the command line utilities used for administration, and their common features.
Provides a hands-on tutorial to acquaint you with the Administration Console, a graphical interface to the Message Queue message server.
Explains how to start up and configure a Message Queue broker and a broker cluster.
Explains how to perform (application-independent) tasks related to managing Message Queue brokers, as well as tasks used to manage messaging applications.
Explains how to perform tasks related to creating and managing Message Queue administered objects.
Explains how to perform security tasks related to applications, such as managing authentication, authorization, and encryption.
Describes techniques for monitoring and analyzing message server performance and explains how to tune the message server to optimize its performance.
Describes the location of various categories of Message Queue data.
Explains how to set up Message Queue to use JDBC-compliant database to perform persistence functions.
Explains how to set up HTTP connection services between a messaging client and the Message Queue message server.
Explains how to use the Message Queue Service Administration utility (imqsvcadmin) to install, query, and remove the broker (running as an Windows service).
Provides a number of specialized technical notes relevant to topics in this book, but not part of Message Queue-specific administration.
Describes what the Message Queue resource adapter is, how to deploy it, and how to configure and use it.
Appendix G, "Message Queue Implementation of Optional JMS Functionality"
Describes how the Message Queue product handles each of the items listed in the JMS specification as optional for a JMS provider to implement.
Describes the stability of various Message Queue interfaces.
Defines terms used in Message Queue documentation.
ConventionsThis section provides information about the conventions used in this document.
Text Conventions
Directory Variable Conventions
Message Queue makes use of three directory variables; how they are set varies from platform to platform. Table 3 describes these variables and summarizes how they are used on the Solaris, Windows, and Linux platforms.
In this guide, IMQ_HOME, IMQ_VARHOME, and IMQ_JAVAHOME are shown without platform-specific environment variable notation or syntax (for example, $IMQ_HOME on UNIX®). Path names generally use UNIX directory separator notation (/).
Other Documentation ResourcesIn addition to this guide, Message Queue provides additional documentation resources.
The Message Queue Documentation Set
The documents that comprise the Message Queue documentation set are listed in Table 4 in the order in which you would normally use them.
Online Help
Message Queue includes command line utilities for performing Message Queue message service administration tasks. To access the online help for these utilities, see "Common Command Line Options".
Message Queue also includes a graphical user interface (GUI) administration tool, the Administration Console (imqadmin). Context sensitive online help is included in the Administration Console.
JavaDoc
Message Queue Java client API (including the JMS API) documentation in JavaDoc format, is provided in a directory that depends upon the operating system (see Appendix A, "Location of Message Queue Data").
This documentation can be viewed in any HTML browser such as Netscape or Internet Explorer. It includes standard JMS API documentation as well as Message Queue-specific APIs for Message Queue administered objects (see Chapter 3 of the Message Queue Java Client Developer’s Guide), which are of value to developers of messaging applications.
Example Client Applications
A number of example applications that provide sample client application code are included in a directory that depends upon the operating system (see Appendix A, "Location of Message Queue Data").
See the README file located in that directory and in each of its subdirectories.
The Java Message Service (JMS) Specification
The JMS specification can be found at the following location:
The specification includes sample client code.
Related Third-Party Web Site ReferencesThird-party URLs are referenced in this document and provide additional, related information.