Sun Java System Message Queue 3 2005Q1 Administration Guide |
Preface
The Sun Java System Message Queue Administration Guide provides the information you need in order to administer a Message Queue messaging system.
This book describes Sun Java System Message Queue 3 2005Q1 (Message Queue 3.6).
This preface contains the following sections:
Who Should Use This BookThis guide is meant for administrators and 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, especially the Message Queue message server at the heart of this system.
Before You Read This BookYou must read the Message Queue Technical Overview to become familiar with the Message Queue implementation of the Java Message Specification, with the components of the Message Queue service, and with the basic process of developing, deploying, and administering a Message Queue application.
How This Book Is OrganizedThe following table briefly describes the contents of the manual.
Table 1 Book Contents
Part/Chapter
Description
Introduces Message Queue administration tasks and tools.
Provides a hands-on tutorial to acquaint you with the Administration Console.
Describes how to start the Message Queue broker and clients.
Describes how configuration properties are set and read, and gives an introduction to the configurable aspects of the broker. Also describes how to set up a file or database to perform persistence functions.
Describes broker management tasks.
Describes management tasks relating to topics and queues.
Explains security-related tasks, such as managing password files, authentication, authorization, and encryption.
Describes the object store and explains how to perform tasks related to destination administered objects and connection factory administered objects.
Describes how to set up and manage a cluster of Message Queue brokers.
Describes how to set up and use Message Queue monitoring facilities.
Describes techniques for analyzing message server performance and explains how to tune the message server to optimize its performance.
Provides suggestions about how to determine the cause of common Message Queue problems, and about the actions you can take to resolve the problems.
Provides syntax and descriptions for the Message Queue command utilities.
List and describes the properties you can use to configure a broker.
List and describes the properties you can use to configure topics and queues.
List and describes the properties you can use to configure destination administered objects and connection factory administered objects.
List and describes the properties you can use to configure the Message Queue resource adapter for use with an application server.
List and describes the metrics produced by a Message Queue broker.
Appendix A, "Operating System-Specific Locations of Message Queue Data"
Lists the location of Message Queue files on each supported platform.
Describes the stability of various Message Queue interfaces.
Describes how to set up use of HTTP for Message Queue communication.
Conventions Used In This BookThis 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 (/).
Related DocumentationIn addition to this guide, Message Queue provides additional documentation resources.
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 Chapter 13, "Command Reference.".
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
JMS and Message Queue API documentation in JavaDoc format is provided at the following location:
Platform
Location
Solaris
/usr/share/javadoc/imq/index.html
Linux
/opt/sun/mq/javadoc/index.html/
Windows
IMQ_HOME/javadoc/index.html
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 Developer’s Guide for Java Clients), 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 platform-specific directory (see Appendix A, "Operating System-Specific Locations 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.
Sun Welcomes Your CommentsSun is interested in improving its documentation and welcomes your comments and suggestions.
To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document.