上一章 目录 索引 下一章 |
Sun Java System Message Queue 3.5 SP1 管理指南

> ## 前言

> 《Sun Java™ System Message Queue 3.5 SP1 管理指南》一书提供了对 Message Queue 消息传送系统执行管理任务所需的背景和信息。

> 本前言包含以下章节：

> - 本指南的读者
> - 本指南的结构
> - 约定
> - 其他文档资源

> ##

> 本指南的读者

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

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

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

> ##

> 本指南的结构

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

> 表 1 本书内容

> 章 | 说明
> --- | ---
> 第 1 章“概述” | 对 Message Queue 消息传送系统及其术语进行了深入地概念综述。
> 第 2 章“Message Queue 消息传送系统” | 论述 Message Queue 消息传送系统，特别是 Message Queue 代理和 Message Queue 客户机运行时，它们协同提供消息传送服务。
> 第 3 章“Message Queue 管理任务和工具” | 论述 Message Queue 管理任务和管理工具，并介绍用于管理的命令行实用程序及其通用功能。
> 第 4 章“管理控制台教程” | 提供一个实用教程，借助此教程，您将了解管理控制台（Message Queue 消息服务器的图形界面）的操作方法。
> 第 5 章“启动与配置代理” | 介绍如何启动和配置 Message Queue 代理和代理群集。
> 第 6 章“代理和应用程序管理” | 介绍如何执行与管理 Message Queue 代理相关的（应用程序无关）任务，以及如何执行用于管理消息传送应用程序的任务。
> 第 7 章“管理受管理对象” | 介绍如何执行与创建和管理 Message Queue 受管理对象相关的任务。
> 第 8 章“管理安全性” | 介绍如何执行与应用程序相关的安全任务，例如管理验证、授权和加密。
> 第 9 章“分析和调整消息服务” | 说明用于监视和分析消息服务器性能的有关技术，并介绍如何调整消息服务器以优化其性能。
> 附录 A“Message Queue 数据的位置” | 说明不同类别的 Message Queue 数据的位置。
> 附录 B“设置插入的持久性” | 介绍如何设置 Message Queue 以使用 JDBC 兼容数据库执行持久性功能。
> 附录 C“HTTP/HTTPS 支持（企业版）” | 介绍如何在消息传送客户机和 Message Queue 消息服务器之间建立 HTTP 连接服务。
> 附录 D“使用代理作为 Windows 服务” | 介绍如何使用 Message Queue 服务管理实用程序 (imqsvcadmin) 安装、查询和删除代理（作为 Windows 服务运行）。
> 附录 E“技术说明” | 提供与本书中涉及的主题相关的大量专业技术说明，但与针对 Message Queue 的管理工作无关。
> 附录 F“Message Queue 资源适配器” | 说明 Message Queue 资源适配器的定义、如何部署它，以及如何配置和使用它。
> 附录 G“Message Queue 实现方案可选的 JMS 功能” | 说明 Message Queue 产品如何处理 JMS 规范中列出的各项内容（JMS 提供者可以选择实现这些项）。
> 附录 H“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/j2sdk Version 目录中查找 Java 运行时，然后再从 /usr/java/j2re Version 目录查找，但是用户可以选择性地将 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 规范：

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

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

> ##

> 相关的第三方 Web 站点参考

> 本文档中所引用的第三方 URL 提供了附加的相关信息。

> 注意 | Sun 对本文档中提到的第三方 Web 站点的可用性不承担任何责任。对于此类站点或资源中的（或通过它们获得的）任何内容、广告、产品或其他材料，Sun 并不表示认可，也不承担任何责任。对于因使用或依靠此类站点或资源中的（或通过它们获得的）任何内容、产品或服务而造成的或连带产生的实际或名义损坏或损失，Sun 概不负责，也不承担任何责任。

> 上一章 目录 索引 下一章

> 版权所有 2004 Sun Microsystems, Inc. 保留所有权利。