前言
本书介绍如何安装 Sun™ Open Net Environment (Sun ONE) Message Queue (MQ) 3.0.1 SP2，前言部分包括以下各节：
本指南的读者
本指南的读者针对的是 MQ 开发者和管理员。
本指南的结构
所有用户应该首先阅读简介，然后再阅读针对不同平台的相应章节。下表简短介绍了各章的内容：
约定
本节介绍本文档中使用的有关约定。
文本约定
表 2 文档约定
|
格式
|
说明
|
|
斜体文本
|
斜体文本代表占位符。斜体文本可用相应地子句或值替换。斜体文本还用来表示文档标题、强调、引入的的单词或短语。
|
|
等宽文本
|
等宽文本用来表示实例代码、输入的命令行命令、目录、文件、路径名、错误信息文本、类名称、方法名称（包括签名中的所有元素）、软件包名称、保留字和 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 根安装目录。因此，在 Solaris 上，MQ 文档不使用 IMQ_HOME 来引用文件位置。
- 在 Solaris 上，对于 Sun ONE Application Server, Evaluation Edition，MQ 根安装目录为：
root Application Server installation directory/imq。
- 在 Windows 上，MQ 根安装目录由 MQ 安装程序设置（默认情况下为 C:\Program Files\Sun Microsystems\Message Queue 3.0）。
- 在 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 上，对于 Sun ONE Application Server, Evaluation Edition，IMQ_VARHOME 默认为 IMQ_HOME/var。
- 在 Windows 上，IMQ_VARHOME 默认为 IMQ_HOME/var。
- 在 Windows 上，对于 Sun ONE Application Server，IMQ_VARHOME 默认为 IMQ_HOME/var。
- 在 Linux 上，IMQ_VARHOME 默认为 IMQ_HOME/var。
|
|
IMQ_JAVAHOME
|
这是一个环境变量，指向 MQ 可执行文件所需的 Java 运行时 (JRE) 的位置：
- 在 Solaris 上，IMQ_JAVAHOME 默认为 /usr/j2se/jre 目录，但是用户可以选择性地将其值设置为存储所需 JRE 的位置。
- 在 Windows 上，IMQ_JAVAHOME 默认为 IMQ_HOME/jre，但是用户可以选择性地将其值设置为存储所需 JRE 的位置。
- 在 Linux 上，MQ 首先在 /usr/java/j2sdkVersion 目录中查找 Java 运行时，然后再在 /usr/java/j2reVersion 目录中查找，但是用户可以选择性地将 IMQ_JAVAHOME 的值设置为存储所需 JRE 的位置。
|
在本指南中，所显示的 IMQ_HOME、IMQ_VARHOME 和 IMQ_JAVAHOME 没有采用各个平台特有的环境变量表示法或语法（例如，在 UNIX 上为 $IMQ_HOME）。所有的路径名采用 UNIX 文件分隔符表示法 (/)。
其它文档资源
除了本指南以外，MQ 还提供了其它文档资源。
MQ 文档集
表 4 按照通常的使用顺序列出了 MQ 文档集中的文档。
表 4 MQ 文档集
|
文档
|
读者
|
说明
|
|
MQ 安装指南
|
开发者和管理员
|
介绍如何在 Solaris、Linux 和 Windows 平台上安装 MQ 软件。
|
|
MQ 发行说明
|
开发者和管理员
|
包含对新功能、限制、已知错误以及技术说明的介绍。
|
|
MQ 开发者指南
|
开发者
|
提供了与 JMS 的 MQ 实现相关的快速入门教程和编程信息。
|
|
MQ 管理员指南
|
管理员，也推荐开发者阅读
|
提供使用 MQ 管理工具执行管理任务时所需的背景和信息。
|
实例客户机应用程序
以下位置含有大量实例应用程序，提供了实例客户机应用程序代码：
IMQ_HOME/demo（在 Solaris 上为 /usr/demo/imq）
请参见位于该目录及其每个子目录中的 README 文件。
