前言
《Sun Java™ System Message Queue 3.5 SP1 管理指南》一书提供了对 Message Queue 消息传送系统执行管理任务所需的背景和信息。
本前言包含以下章节：
本指南的读者
本指南供需要执行 Message Queue 管理任务的系统管理员以及应用程序开发者使用。
Message Queue 管理员负责设置和管理 Message Queue 消息传送系统，特别是该系统的核心 Message Queue 消息服务器。本书并不要求读者掌握所有消息传送系统的知识或对其有一定了解。
本指南也供应用程序开发者使用，使其更好地了解如何优化应用程序，从而充分利用 Message Queue 消息传送系统的功能和灵活性。
本指南的结构
请从头到尾按部就班地阅读本指南。下表简要介绍了各章的内容：
约定
本节介绍本文档中使用的有关约定。
文本约定
表 2 文档约定
|
格式
|
说明
|
|
斜体文本
|
斜体文本代表占位符。斜体文本可用相应地子句或值替换。斜体文本还用来表示文档标题、强调、引入的的单词或短语。
|
|
等宽文本
|
等宽文本表示实例代码、在命令行输入的命令、目录、文件、路径名、错误消息文本、类名称、方法名称（包括签名中的所有元素）、软件包名称、保留字和 URL。
|
|
[]
|
方括号用来表示命令行语法语句中的可选值。
|
|
全部大写文本
|
全部大写的文本表示文件系统类型（GIF、TXT、HTML 等）、环境变量 (IMQ_HOME) 或首字母缩略词（Message Queue、JSP）。
|
|
键名 + 键名
|
用加号连接的一组同时按下的键：Ctrl+A 表示同时按下这两个键。
|
|
键名 - 键名
|
用连字符连接的一组依次按下的键：Esc-S 表示先按 Esc 键，然后释放它，再按 S 键。
|
目录变量约定
Message Queue 使用三种目录变量；其设置因平台而异。表3 介绍了这些变量并概述了如何在 Solaris、Windows 和 Linux 平台上使用这些变量。
表 3 Message Queue 目录变量
|
变量
|
说明
|
|
IMQ_HOME
|
Message Queue 文档中通常使用此变量，表示 Message Queue 根目录（根安装目录）：
- Solaris 平台上，不存在 Message Queue 根安装目录。因此，Message Queue 文档中不使用 IMQ_HOME 表示 Solaris 平台上的文件位置。
- Solaris 平台上，对于 Sun Java System Application Server，Message Queue 根安装目录为 Application Server 根目录下的 /imq。
- Windows 平台上，Message Queue 根安装目录由 Message Queue 安装程序设置（默认情况下为 C:\Program Files\Sun\MessageQueue3）。
- Windows 平台上，对于 Sun Java System Application Server，Message Queue 根安装目录为 Application Server 根目录下的 /imq。
- Linux 平台上，不存在 Message Queue 根安装目录。因此，Message Queue 文档中不使用 IMQ_HOME 表示 Linux 平台上的文件位置。
|
|
IMQ_VARHOME
|
这是 /var 目录，其中存储了 Message Queue 临时或动态创建的配置和数据文件。可设置为指向任何目录的环境变量。
- Solaris 平台上，IMQ_VARHOME 默认为 /var/imq 目录。
- Solaris 平台上，对于 Sun Java System Application Server 测试版，IMQ_VARHOME 默认为 IMQ_HOME/var 目录。
- Windows 平台上，IMQ_VARHOME 默认为 IMQ_HOME\var 目录。
- Windows 平台上，对于 Sun Java System Application Server，IMQ_VARHOME 默认为 IMQ_HOME\var 目录。
- Linux 平台上，IMQ_VARHOME 默认为 /var/opt/imq 目录。
|
|
IMQ_JAVAHOME
|
这是一个环境变量，指向 Message Queue 可执行文件所需的 Java 运行时 (JRE) 的位置：
- Solaris 平台上，IMQ_JAVAHOME 默认为 /usr/j2se/jre 目录，但是用户可以选择性地将其值设置为所需的 JRE 驻留的位置。
- Windows 平台上，IMQ_JAVAHOME 默认为 IMQ_HOME\jre，但是用户可以选择性地将其值设置为所需的 JRE 驻留的位置。
- Linux 平台上，Message Queue 首先在 /usr/java/j2sdkVersion 目录中查找 Java 运行时，然后再从 /usr/java/j2reVersion 目录查找，但是用户可以选择性地将 IMQ_JAVAHOME 的值设置为所需的 JRE 驻留的位置。
|
在本指南中，显示 IMQ_HOME、IMQ_VARHOME 和 IMQ_JAVAHOME 时，不使用特定平台的环境变量表示法或语法（例如，在 UNIX 平台上为 $IMQ_HOME）。路径名通常采用 UNIX 目录分隔符表示法 (/)。
其他文档资源
除本指南外，Message Queue 还提供了其他文档资源。
Message Queue 文档集
表4 按照通常的使用顺序列出了 Message Queue 文档集中的文档。-
表 4 Message Queue 文档集
|
文档
|
读者
|
说明
|
|
《Message Queue 安装指南》
|
开发者和管理员
|
介绍如何在 Solaris、Linux 和 Windows 平台上安装 Message Queue 软件。
|
|
《Message Queue 发行说明》
|
开发者和管理员
|
包含对新功能、限制、已知错误以及技术说明的介绍。
|
|
《Message Queue 管理指南》
|
管理员，也推荐开发者阅读
|
提供使用 Message Queue 管理工具执行管理任务时所需的背景和信息。
|
|
《Message Queue Java Client Developer's Guide》
|
开发者
|
为使用 JMS 和 SOAP/JAXM 规范 Message Queue 实现方案开发 Java 客户机程序的人员提供快速入门教程和编程信息。
|
|
《Message Queue C Client Developers Guide》
|
开发者
|
为使用 Message Queue 消息服务的 C 接口 (C-API) 开发 C 客户机程序的人员提供编程和参考文档。
|
联机帮助
Message Queue 包含用于执行 Message Queue 消息服务的管理任务的命令行实用程序。 要访问这些实用程序的联机帮助，请参见“通用命令行选项”。
Message Queue 还包含图形用户界面 (GUI) 管理工具，即管理控制台 (imqadmin)。管理控制台包含上下文有关联机帮助。
JavaDoc
JavaDoc 格式的 Message Queue Java 客户机 API（包含 JMS API）文档所在的目录取决于操作系统（请参见附录 A“Message Queue 数据的位置”）。
此文档可以在任何 HTML 浏览器中浏览，如 Netscape 或 Internet Explorer。它包括标准 JMS API 文档以及 Message Queue 受管理对象的 Message Queue 特定 API（请参见《Message Queue Java Client Developer's Guide》的第3 章），这些对消息传送应用程序的开发者很有帮助。
示例客户机应用程序
许多示例应用程序提供了样例客户机应用程序代码，这些示例应用程序所在的目录取决于操作系统（请参见附录 A“Message Queue 数据的位置”）。
请参见位于该目录及其每个子目录中的 README 文件。
Java 消息服务 (JMS) 规范
可以在以下位置查找 JMS 规范：
规范包含样例客户机代码。
相关的第三方 Web 站点参考
本文档中所引用的第三方 URL 提供了附加的相关信息。
|
|
注意
|
Sun 对本文档中提到的第三方 Web 站点的可用性不承担任何责任。对于此类站点或资源中的（或通过它们获得的）任何内容、广告、产品或其他材料，Sun 并不表示认可，也不承担任何责任。对于因使用或依靠此类站点或资源中的（或通过它们获得的）任何内容、产品或服务而造成的或连带产生的实际或名义损坏或损失，Sun 概不负责，也不承担任何责任。
|
|
