前言
本 Sun Java SystemTM Message Queue 管理指南为设置和管理 Sun Java System Message QueueTM 消息传送系统的系统管理员提供所需的背景和信息。
目标读者
本手册的目标读者为需要执行 Message Queue 管理任务的管理员和应用程序开发者。 Message Queue 管理员负责设置和管理 Message Queue 消息传送系统，尤其是处于该系统核心的消息代理。
阅读本书之前
阅读本手册之前，应阅读《Sun Java System Message Queue 3.7 UR1 技术概述》，以熟悉 Java 消息服务规范的 Message Queue 实现、Message Queue 服务的组件以及开发、部署和管理 Message Queue 应用程序的基本过程。
本书的结构
表 P–1 介绍了本手册的内容。
表 P–1 本手册的内容|
部分/章节 |
描述 |
|---|---|
|
介绍 Message Queue 管理任务和工具。 |
|
|
提供一个实用教程，以帮助您熟悉 Message Queue 管理控制台。 |
|
|
介绍如何启动 Message Queue 代理和客户端。 |
|
|
介绍如何设置和读取配置属性，并简要介绍了代理的可配置部分。 此外，还介绍了如何设置文件或数据库以执行持久性功能。 |
|
|
介绍代理管理任务。 |
|
|
介绍与物理目的地相关的管理任务。 |
|
|
介绍与安全相关的任务，例如管理密码文件、验证、授权和加密。 |
|
|
介绍对象存储库，并说明如何执行与受管理对象（连接工厂和目的地）相关的任务。 |
|
|
介绍如何设置和管理 Message Queue 代理群集。 |
|
|
介绍如何设置和使用 Message Queue 监视工具。 |
|
|
介绍分析和优化消息服务性能的技术。 |
|
|
提供有关确定 Message Queue 常见问题的原因以及可以采取哪些措施来解决这些问题的建议。 |
|
|
提供 Message Queue 命令行实用程序的语法和说明。 |
|
|
介绍 Message Queue 消息代理的配置属性。 |
|
|
介绍物理目的地的配置属性。 |
|
|
介绍受管理对象（连接工厂和目的地）的配置属性。 |
|
|
介绍 Message Queue 资源适配器（与应用服务器一起使用）的配置属性。 |
|
|
介绍 Message Queue 消息代理提供用于监视、调整和诊断目的的度量信息。 |
|
|
列出每个受支持平台上 Message Queue 文件的位置。 |
|
|
介绍不同 Message Queue 接口的稳定性。 |
|
|
介绍如何设置和使用用于 Message Queue 通信的超文本传输协议 (Hypertext Transfer Protocol, HTTP )。 |
|
|
列出一些常用的 Message Queue 命令实用程序 (imqcmd) 命令。 |
|
相关文档
下表按照通常的使用顺序列出了 Message Queue 文档集中的文档。
表 P–2 Message Queue 文档集|
文档 |
读者 |
描述 |
|---|---|---|
|
开发者和管理员 |
介绍如何在 Solaris、Linux 和 Windows 平台上安装 Message Queue 软件。 |
|
|
开发者和管理员 |
包含新功能、局限性、已知错误以及技术说明的介绍。 |
|
|
开发者和管理员 |
介绍了 Message Queue 的概念、功能和组件。 |
|
|
《Sun Java System Message Queue 3.7 UR1 Developer’s Guide for Java Clients 》 |
开发者 |
为使用 JMS 或 SOAP/JAXM API 的 Message Queue 实现方案的 Java 客户端程序开发者提供快速入门教程和编程信息。 |
|
管理员（也可推荐给开发者） |
提供使用 Message Queue 管理工具执行管理任务所需的背景和信息。 |
|
|
《Sun Java System Message Queue 3.7 UR1 Developer’s Guide for C Clients 》 |
开发者 |
为使用 JMS API (C-API) 的 Message Queue C 实现方案的 C 客户端程序开发者提供编程和参考文档。 |
联机帮助
Message Queue 3.7 UR1 包含用于执行 Message Queue 消息服务管理任务的命令行实用程序。
Message Queue 3.7 UR1 还包含图形用户界面 (Graphical User Interface, GUI) 管理工具，即管理控制台 (imqadmin)。管理控制台包含上下文有关帮助；请参见管理控制台联机帮助。
JavaDoc
以下位置提供了 JavaDoc 格式的 JMS 和 Message Queue API 文档：
|
平台 |
位置 |
|---|---|
|
Solaris |
/usr/share/javadoc/imq/index.html |
|
Linux |
/opt/sun/mq/javadoc/index.html |
|
Windows |
IMQ_HOME/javadoc/index.html |
可以在任何 HTML 浏览器中浏览此文档。它包括标准 JMS API 文档以及 Message Queue 受管理对象的特定于 Message Queue 的 API，这些对消息传送应用程序的开发者很有帮助。
示例客户端应用程序
Message Queue 提供了大量示例客户端应用程序，为开发者提供帮助。
示例 Java 客户端应用程序
示例 Java 客户端应用程序位于以下目录中（具体位置取决于平台）。请参见位于这些目录及其每个子目录中的 README 文件。
|
平台 |
位置 |
|---|---|
|
Solaris |
/usr/demo/imq/ |
|
Linux |
/opt/sun/mq/examples |
|
Windows |
IMQ_HOME/demo/ |
示例 C 客户端程序
示例 C 客户端应用程序位于以下目录中（具体位置取决于平台）。请参见位于这些目录中的 README 文件。
|
平台 |
位置 |
|---|---|
|
Solaris |
/opt/SUNWimq/demo/C/ |
|
Linux |
/opt/sun/mq/examples/C/ |
|
Windows |
IMQ_HOME/demo/C/ |
Java 消息服务 (Java Message Service, JMS) 规范
可以在以下位置找到 JMS 规范：
规范包括样例客户端代码。
目录变量约定
Message Queue 使用三个目录变量；它们的设置方法因平台而异。表 P–3 介绍了这些变量以及如何在 Solaris、 Linux 和 Windows 平台上使用它们。
注 –
表 P–3 中的信息仅适用于 Message Queue 的独立安装。安装 Message Queue 并将其作为应用服务器安装的一部分运行时，目录变量值的设置有所不同：IMQ_HOME 被设置为 appServer_install_dir/imq（其中 appServer_install_dir 是应用服务器安装目录），而 IMQ_VARHOME 被设置为 appServer_domainName_dir/imq（其中 appServer_domainName_dir 是启动 Message Queue 代理的域的域目录）。
表 P–3 目录变量约定
在本指南中，显示 IMQ_HOME 、IMQ_VARHOME 和 IMQ_JAVAHOME 时，不使用特定于平台的环境变量表示法或语法（例如，在 UNIX 平台上为 $IMQ_HOME）。路径名通常采用 UNIX 目录分隔符表示法 (/)。
印刷约定
下表描述了本书中使用的印刷约定。
表 P–4 印刷约定|
字体或符号 |
含义 |
示例 |
|---|---|---|
|
AaBbCc123 |
命令、文件和目录的名称；计算机屏幕输出 |
编辑 .login 文件。 使用 ls -a 列出所有文件。 machine_name% you have mail. |
|
AaBbCc123 |
用户键入的内容，与计算机屏幕输出的显示不同 |
machine_name% su Password: |
|
aabbcc123 |
要使用实名或值替换的占位符 |
用于删除文件的命令为 rm filename。 |
|
AaBbCc123 |
保留未译的新词或术语以及要强调的词（注意：某些强调的词在联机状态下以粗体显示） |
这些称为 Class 选项。 |
|
新词术语强调 |
新词或术语以及要强调的词 |
缓存是存储在本地的副本。 不要保存文件。 |
|
《书名》 |
书名 |
阅读《用户指南》的第 6 章。 |
命令示例中的 Shell 提示符
下表显示了默认 UNIX® 系统提示符和 C shell、Bourne shell、Korn shell 及 Windows 操作系统的超级用户提示符。
表 P–5 Shell 提示符|
Shell |
提示符 |
|---|---|
|
C shell |
machine_name% |
|
超级用户的 C shell |
machine_name# |
|
Bourne shell 和 Korn shell |
$ |
|
超级用户的 Bourne shell 和 Korn shell |
# |
|
Windows |
C:\ |
符号约定
下表对本书中可能使用的符号进行了解释。
表 P–6 符号约定|
符号 |
描述 |
示例 |
含义 |
|---|---|---|---|
|
[ ] |
包含可选的参数和命令选项。 |
ls [-l] |
-l 不是必需选项。 |
|
{ | } |
包含必需命令选项的选项集。 |
-d {y|n} |
-d 选项要求您使用参数 y 或参数 n。 |
|
${ } |
表示变量引用。 |
${com.sun.javaRoot} |
引用 com.sun.javaRoot 变量的值。 |
|
- |
连接需要同时按下的多个键。 |
Ctrl-A |
在按 A 键的同时按 Ctrl 键。 |
|
+ |
连接需要连续按下的多个键。 |
Ctrl+A+N |
按 Ctrl 键，再将其释放，然后按后续键。 |
|
-> |
表示图形用户界面中的菜单项选择。 |
“文件”->“新建”->“模板” |
从“文件”菜单中选择“新建”。 从“新建”子菜单中选择“模板”。 |
文档、支持和培训
Sun 的 Web 站点提供了有关其他资源的信息，如下所示：
搜索 Sun 产品文档
除了从 docs.sun.com Web 站点搜索 Sun 产品文档之外，还可以通过在搜索字段中键入以下语法来使用搜索引擎进行搜索
search-term site:docs.sun.com |
例如，要搜索 "broker"，请键入以下内容：
broker site:docs.sun.com |
要将其他 Sun Web 站点（如 java.sun.com、www.sun.com 和 developers.sun.com）包含在搜索中，请在搜索字段中使用 "sun.com" 代替 "docs.sun.com"。
第三方 Web 站点引用
本文档引用了第三方 URL 以提供其他相关信息。
注 –
Sun 对本文档中提到的第三方 Web 站点的可用性不承担任何责任。对于此类站点或资源中的（或通过它们获得的）任何内容、广告、产品或其他材料，Sun 并不表示认可，也不承担任何责任。对于因使用或依靠此类站点或资源中的（或通过它们获得的）任何内容、产品或服务而造成的或连带产生的实际或名义损坏或损失，Sun 概不负责，也不承担任何责任。
Sun 欢迎您提出意见
Sun 致力于提高其文档的质量，并十分乐意收到您的意见和建议。要共享您的意见，请访问 http://docs.sun.com，然后单击“发送意见”(Send Comments)。在联机表单中提供完整的文档标题和文件号码。文件号码包含 7 位或 9 位数字，可在书的标题页或在文档的 URL 中找到该号码。例如，本书的文件号码是 820-0843。
- © 2010, Oracle Corporation and/or its affiliates