前言

《Sun™ ONE Message Queue (MQ) 3.0.1 管理员指南》这本书提供了执行 MQ 消息传送系统的管理任务所需的背景和信息。

本前言包含以下章节：

• 本指南的读者
• 本指南的结构
• 惯例
• 其它文档资源

本指南的读者

---

本指南供需要执行 MQ 管理任务的系统管理员以及应用程序开发者使用。

MQ 管理员负责设置和管理 MQ 消息传送系统，特别是该系统的核心 MQ － 消息服务器。本书并不要求读者掌握任何消息传送系统的知识或对其有一定了解。

本指南也供应用程序开发者使用，使他们更好地了解如何优化应用程序，从而充分利用 MQ 消息传送系统的功能和灵活性。

本指南的结构

---

请从头到尾按部就班地阅读本指南。下表简要介绍了各章的内容：

表 1    本书内容 

章	说明
第 1 章“概述”	对 MQ 消息传送系统及其术语进行了高级概念综述。
第 2 章“MQ 消息传送系统”	说明 MQ 消息传送系统，重点介绍了协同工作以提供消息传送服务的 MQ 代理和 MQ 客户机运行时。
第 3 章“MQ 管理”	介绍 MQ 管理任务和管理工具，并介绍了用于管理的命令行公用程序及其通用功能。
第 4 章“管理控制台教程”	提供一个实用教程，借助此教程，您将熟练掌握管理控制台（MQ 消息服务器的图形界面）的操作方法。
第 5 章“启动与配置代理”	介绍如何启动和配置 MQ 代理和代理群集。
第 6 章“代理和应用程序管理”	介绍如何执行与管理 MQ 代理相关的（应用程序无关）任务，以及如何执行用于管理消息传送应用程序的任务。
第 7 章“管理被管理对象”	介绍如何执行与创建和管理 MQ 被管理对象相关的任务。
第 8 章“安全性管理”	介绍如何执行与应用程序相关的安全任务，例如管理验证、授权和加密。
附录 A“设置插入的持久性”	介绍如何设置 MQ 以使用 JDBC 兼容数据库执行持久性功能。
附录 B“HTTP/HTTPS 支持（企业版）”	介绍如何在消息传送客户机和 MQ 消息服务器之间建立 HTTP 连接服务。
附录 C“使用代理作为 Windows 服务”	介绍如何使用 MQ 服务管理公用程序 (imqsvcadmin) 安装、查询和删除代理（作为 Windows 服务运行）。
附录 D“MQ 数据的位置”	说明不同类别的 MQ 数据的位置。
附录 E“MQ 接口的稳定性”	说明不同 MQ 接口的稳定性。
词汇表	定义在 MQ 文档中使用的术语。

惯例

---

本节介绍本文档中使用的有关惯例。

文本惯例

表 2    文档惯例 

格式	说明
斜体文本	italics 表示占位符。可用相应的子句或值替换斜体文本。斜体文本还用于表示文档标题、强调、引入的词或短语。
等宽文本	monospace 表示实例代码、在命令行上输入的命令、目录、文件、路径名、错误信息文本、类名称、方法名称（包括签名中的所有元素）、软件包名称、保留字和 URL。
[]	方括号表示命令行语法语句中的可选值。
全部大写文本	全部大写文本表示文件系统类型（GIF、TXT、HTML 等）、环境变量 (IMQ_HOME) 或首字母缩略词（MQ、JSP）。
键名 + 键名	用加号连接的一组同时按下的键：Ctrl+A 表示同时按下这两个键。
键名 - 键名	用连字符连接的一组依次按下的键：Esc-S 表示先按 Esc 键，然后释放它，再按 S 键。

目录变量惯例

MQ 使用三种目录变量，不同平台的变量设置有所不同。表 3 介绍了这些变量并概述了如何在 Solaris、Windows 和 Linux 平台上使用这些变量。

表 3    MQ 目录变量 

变量	说明
IMQ_HOME>	MQ 文档中通常使用它来引用 MQ 根安装目录： 在 Solaris 平台上，不存在 MQ 根安装目录。因此，MQ 文档不使用 IMQ_HOME 来引用在 Solaris 上的文件位置。 在 Solaris 平台上，对于 Sun ONE Application Server 测试版，MQ 根安装目录为： root Application Server installation directory/imq。 在 Windows 平台上， 根安装目录是由 MQ 安装程序MQ设置（默认情况下为 C:\Program Files\Sun Microsystems\Message Queue 3.0.1）。 在 Windows 平台上，对于 Sun ONE Application Server，MQ 根安装目录为： root Application Server installation directory/imq。 在 Linux 平台上，默认的 MQ 根安装目录为：/opt/imq。
IMQ_VARHOME>	这是 /var 目录，其中存储了 MQ 临时或动态创建的配置和数据文件。可设置为指向任何目录的环境变量。 在 Solaris 平台上，默认的 IMQ_VARHOME 为 /var/imq 目录。 在 Solaris 平台上，默认的 IMQ_VARHOME 为 IMQ_HOME/var（仅适用于 Sun ONE Application Server，测试版）。 在 Windows 平台上，默认的 IMQ_VARHOME 为 IMQ_HOME/var。 在 Windows 平台上，默认的 IMQ_VARHOME 为 IMQ_HOME/var（仅适用于 Sun ONE Application Server）。 在 Linux 平台上，默认的 IMQ_VARHOME 为 IMQ_HOME/var。
IMQ_JAVAHOME>	这是一个环境变量，指向 MQ 可执行文件所需的 Java 运行时 (JRE 1.4) 的位置： 在 Solaris 平台上，默认的 IMQ_JAVAHOME 为 /usr/j2se/jre 目录，但是用户可以选择将其值设置为存储 JRE 1.4 的位置。 在 Windows 平台上，默认的 IMQ_JAVAHOME 为 IMQ_HOME/jre，但是用户可以选择将其值设置为存储 JRE 1.4 的位置。 在 Linux 平台上，默认的 IMQ_JAVAHOME 为 /usr/java/j2sdk1.0/jre 目录，但是用户可以选择将其值设置为存储 JRE 1.4 的位置。

在本指南中，所显示的 IMQ_HOME、IMQ_VARHOME 和 IMQ_JAVAHOME 没有采用各个平台特有的环境变量表示法或语法（例如，在 UNIX 上为 $IMQ_HOME）。所有的路径名采用 UNIX 文件分隔符表示法 (/)。

其它文档资源

---

除了本指南以外，MQ 还提供了其它文档资源。

MQ 文档集

表 4 按照通常的使用顺序列出了 MQ 文档集中的文档。

表 4    MQ 文档集 

文档	读者	说明
MQ 安装指南	开发者和管理员	介绍如何在 Solaris、Linux 和 Windows 平台上安装 MQ 软件。
发行说明	开发者和管理员	包含对新功能、限制、已知错误以及技术说明的介绍。
MQ Developer's Guide	开发者	提供了与 JMS 的 MQ 实现方案相关的快速入门教程和编程信息。
MQ 管理员指南	管理员，也建议开发者阅读	提供使用 MQ 管理工具执行管理任务时所需的背景和信息。

联机帮助

MQ 3.0.1 包含用于执行 MQ 消息服务的管理任务的命令行公用程序。要访问这些公用程序的联机帮助，请参见通用命令行选项。

MQ 3.0.1 还包含图形用户界面 (GUI) 管理工具，即管理控制台 (imqadmin)。管理控制台包含上下文有关联机帮助。

JavaDoc

在以下位置提供了 JMS 和 MQ API 文档（JavaDoc 格式）：

IMQ_HOME/javadoc/index.html
（在 Solaris 上为：/usr/share/javadoc/imq/index.html）

此文档可以在任何 HTML 浏览器中浏览，例如 Netscape 或 Internet Explorer。它包括标准 JMS API 文档以及 MQ 被管理对象的 MQ 特有 API（请参见《MQ Developer's Guide》的第 3 章），这些对消息传送应用程序的开发者很有帮助。

客户机应用程序示例

以下位置含有大量应用程序示例，提供了范例客户机应用程序代码：

IMQ_HOME/demo（在 Solaris 上为 /usr/demo/imq）

请参见位于该目录及其每个子目录中的 README 文件。

Java 消息服务 (JMS) 规范

请在以下位置查找 JMS 规范：

http://java.sun.com/products/jms/docs.html

规范包含范例客户机代码。