Sun ONE Message Queue, Version 3.0.1 Developer's Guide |
PrefaceThis book provides information about the concepts and procedures needed by a developer of messaging applications in a Sun ONE Message Queue (MQ) environment.
This preface contains the following sections:
Audience for This Guide
This guide is meant principally for developers of applications that exchange messages using an MQ messaging system.
These applications use the Java Message Service (JMS) Application Programming Interface (API). and possibly the Java XML Messaging (JAXM) API, to create, send, receive, and read messages. The JMS and JAXM specifications are open standards.
This Developer's Guide assumes that you are familiar with the JMS API's and with JMS programming guidelines. Its purpose is to help you optimize your JMS client applications by making best use of the features and flexibility of an MQ messaging system.
This Developer's Guide assumes no familiarity, however, with the JAXM APIs or with JAXM programming guidelines. This material is described in Chapter 5, "Working With SOAP Messages," which only assumes basic knowledge of XML.
Organization of This Guide
This guide is designed to be read from beginning to end. The following table briefly describes the contents of each chapter:
Conventions
This 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). All path names use UNIX file separator notation (/).
Other Documentation Resources
In 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.
JavaDoc
JMS and MQ API documentation in JavaDoc format, is provided at the following location:
IMQ_HOME/javadoc/index.html
(/usr/share/javadoc/imq/index.html on Solaris)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 API's for MQ administered objects (see Chapter 3 "Using Administered Objects"), 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 the following location:
IMQ_HOME/demo (/usr/demo/imq on Solaris)
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:
http://java.sun.com/products/jms/docs.html
The specification includes sample client code.
The Java XML Messaging (JAXM) Specification
The JAXM specification can be found at the following location:
http://java.sun.com/xml/downloads/jaxm.htm
The specification includes sample client code.
Books on JMS Programming
For background on using the JMS API, you can consult the following publicly-available books:
- Java Message Service by Richard Monson-Haefel and David A. Chappell, O'Reilly and Associates, Inc., Sebastopol, CA
- Professional JMS Programming by Scott Grant, Michael P. Kovacs, Meeraj Kunnumpurath, Silvano Maffeis, K. Scott Morrison, Gopalan Suresh Raj, Paul Giotta, and James McGovern, Wrox Press Inc., ISBN: 1861004931
- Practical Java Message Service by Tarak Modi, Manning Publications, ISBN: 1930110138