前言
本書解釋了如何安裝 Sun™ 開放式網路環境 (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 根安裝目錄。因此，未在 MQ 說明文件中使用 IMQ_HOME 來指代 Solaris 上的檔案位置。
- 在 Solaris 上，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
|
這是儲存 MQ 暫存檔或動態建立的配置檔與資料檔的 /var 目錄。可以將它設定為指向任何目錄的環境變數。
- 在 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 說明文件集
構成 MQ 說明文件集的說明文件依照一般的使用次序列示在表格 4 中。
表格 4 MQ 說明文件集
|
文件
|
使用者
|
描述
|
|
MQ 安裝指南
|
開發人員與管理員
|
解釋如何在 Solaris、Linux 以及 Windows 平台上安裝 MQ 軟體。
|
|
MQ 版次注意事項
|
開發人員與管理員
|
包括對新功能、限定、已知錯誤以及技術性注意事項的描述。
|
|
MQ 開發人員指南
|
開發人員
|
提供快速啟動指導以及與 JMS MQ 實作相關的程式設計資訊。
|
|
MQ 管理員指南
|
管理員，也建議開發人員使用
|
提供使用 MQ 管理工具執行管理工作時所需的背景與資訊。
|
範例用戶端應用程式
以下位置中包括一些提供範例用戶端應用程式碼的範例應用程式：
IMQ_HOME/demo (在 Solaris 上為 /usr/demo/imq)
請參閱該目錄及其各個子目錄中的 README 檔案。
