Sun Java System Message Queue 3 2005Q4 Administration Guide |
Preface
This Sun Java System Message Queue Administration Guide describes Sun Java System Message Queue 3 2005Q4 (Message Queue 3.6), providing the information you need in order to administer a Message Queue messaging system.
This preface contains the following sections:
Who Should Use This BookThis manual is intended for administrators and application developers who need to perform Message Queue administrative tasks. A Message Queue administrator is responsible for setting up and managing a Message Queue messaging system, especially the message server at the heart of the system.
Before You Read This BookBefore reading this manual, you should 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 OrganizedTable 1 briefly describes the contents of this manual.
Table 1 Contents of This Manual
Part/Chapter
Description
Introduces Message Queue administrative tasks and tools.
Provides a hands-on tutorial to acquaint you with the Message Queue 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 physical destinations.
Describes security-related tasks, such as managing password files, authentication, authorization, and encryption.
Describes the object store and shows how to perform tasks related to administered objects (connection factories and destinations).
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 and optimizing message server performance.
Provides suggestions for determining the cause of common Message Queue problems and the actions you can take to resolve them.
Provides syntax and descriptions for Message Queue command utilities.
Lists and describes the properties you can use to configure a broker.
Lists and describes the properties you can use to configure physical destinations.
Lists and describes the properties you can use to configure administered objects (connection factories and destinations).
Lists and describes the properties you can use to configure the Message Queue Resource Adapter for use with an application server.
Lists and describes the metrics produced by a Message Queue broker.
Appendix A, "Platform-Specific Locations of Message Queue Data"
Lists the locations of Message Queue files on each supported platform.
Describes the stability of various Message Queue interfaces.
Describes how to set up and use the Hypertext Transaction protocol (HTTP) for Message Queue communication.
Lsts some frequently used Message Queue Command utility (imqcmd) commands.
Conventions Used In This BookThis section describes the conventions used in this manual.
Text Conventions
Table 2 summarizes the text conventions used in this manual.
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 how they are used on the Solaris, Linux, and Windows platforms.
Note
In this manual, directory variables are shown without the usual platform-specific syntax (such as $IMQ_HOME on UNIX). Path names generally use UNIX directory separator notation (/).
Related DocumentationThe information resources listed in this section provide further information about Message Queue in addition to that provided in this manual.
Message Queue Documentation Set
The Message Queue documentation set comprises the documents listed in Table 4.
Java Message Service Specification
The Message Queue message service conforms to the Java Message Service (JMS) application programming interface, described in the Java Message Service Specification. This document can be found at the URL
http://java.sun.com/products/jms/docs.html
Online Help
Online help is available for the Message Queue command line utilities; see Chapter 13, "Command Line Reference," for details. The Message Queue graphical user interface (GUI) administration tool, the Administration Console, also includes a context-sensitive online help facility; see Administration Console Online Help.
JavaDoc
JMS and Message Queue API documentation in JavaDoc format is provided at the locations shown in Table 5. 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.
Table 5 JavaDoc Locations
Platform
Location
Solaris
/usr/share/javadoc/imq/index.html
Linux
/opt/sun/mq/javadoc/index.html/
Windows
IMQ_HOME/javadoc/index.html
Example Client Applications
The Message Queue installation includes a directory containing several example client applications. See Appendix A, "Platform-Specific Locations of Message Queue Data," for exact locations depending on the particular platform you are using. The README files located in that directory and in each of its subdirectories provide descriptive information about the example applications.
Related Third-Party Web SitesWhere relevant, this manual refers to third-party URLs that provide additional, related information.
Sun Welcomes Your CommentsSun is always interested in improving its documentation and welcomes your comments and suggestions. To share your comments, go to
and click Send comments. In the resulting online form, provide the document title and part numberd along with your comment. (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.)