Sun ONE Message Queue 3.5 Administrator's Guide |
Preface
This book, the Sun Open Net Environment (Sun ONE) Message Queue (MQ) 3.5 Administrator’s Guide, provides the background and information needed to perform administration tasks for an MQ 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 MQ administration tasks.
An MQ administrator is responsible for setting up and managing an MQ messaging system, in particular the MQ 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 MQ 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 MQ messaging systems and terminology.
Describes the MQ messaging system, with special emphasis on the MQ broker and the MQ client runtime that together provide messaging services.
Describes MQ 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 MQ message server.
Explains how to start up and configure an MQ broker and a broker cluster.
Explains how to perform (application-independent) tasks related to managing MQ brokers, as well as tasks used to manage messaging applications.
Explains how to perform tasks related to creating and managing MQ 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 MQ data.
Explains how to set up MQ to use JDBC-compliant database to perform persistence functions.
Explains how to set up HTTP connection services between a messaging client and the MQ message server.
Explains how to use the MQ 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 MQ-specific administration.
Describes what the MQ resource adapter is, how to deploy it, and how to configure and use it.
Appendix H, "MQ Implementation of Optional JMS Functionality"
Describes how the MQ product handles each of the items listed in the JMS specification as optional for a JMS provider to implement. .
Describes the stability of various MQ interfaces.
Defines terms used in MQ documentation.
ConventionsThis section provides information about the conventions used in this document.
Text Conventions
Directory Variable Conventions
MQ 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, MQ provides additional documentation resources.
The MQ Documentation Set
The documents that comprise the MQ documentation set are listed in Table 4 in the order in which you would normally use them.
Online Help
MQ includes command line utilities for performing MQ message service administration tasks. To access the online help for these utilities, see "Common Command Line Options".
MQ also includes a graphical user interface (GUI) administration tool, the Administration Console (imqadmin). Context sensitive online help is included in the Administration Console.
JavaDoc
MQ 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 MQ 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 MQ-specific APIs for MQ administered objects (see Chapter 3 of the MQ 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 MQ 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.