前言

「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「選擇性 JMS 功能的 Message Queue 實施」	描述 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	這是儲存 Message Queue 暫存檔或動態建立的配置檔與資料檔的 /var 目錄。可以將它配置為指向任何目錄的環境變數。在 Solaris 上，IMQ_VARHOME 預設為 /var/imq 目錄。在 Solaris 上，針對 Sun Java System Application Server, Evaluation Edition，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/j2sdkVersion 目錄中查找 Java 執行階段，然後在 /usr/java/j2reVersion 目錄中查找，但是，使用者可以選擇性地將 IMQ_JAVAHOME 的值配置為所需 JRE 駐留的任意位置。

在本指南中，IMQ_HOME、IMQ_VARHOME 以及 IMQ_JAVAHOME 的顯示不附帶平台特定的環境變數表示法或語法 (例如 UNIX 上的 $IMQ_HOME)。路徑名稱通常使用 UNIX 目錄分隔符號表示法 (/)。

其他說明文件資源

除了本指南以外，Message Queue 還提供了其他說明文件資源。

Message Queue 說明文件集

構成 Message Queue 說明文件集的說明文件依照一般的使用次序列示在表 4 中。

表 4 Message Queue 說明文件集
文件	使用者	說明
Message Queue 安裝指南	開發人員與管理員	解釋如何在 Solaris、Linux 以及 Windows 平台上安裝 Message Queue 軟體。
Message Queue 版本說明	開發人員與管理員	包括對新功能、限定、已知錯誤以及技術性注意事項的描述。
Message Queue 管理指南	管理員，也建議開發人員使用	提供使用 Message Queue 管理工具執行管理工作時所需的背景與資訊。
Message Queue Java 用戶端開發人員指南	開發人員	提供使用 Java 用戶端程式的開發人員快速入門教學和程式設計資訊，以使用 JMS 和 SOAP/JAXM 規格的 Message Queue 實施。
Message Queue C 用戶端開發人員指南	開發人員	提供 C 用戶端程式的開發人員程式設計和參考說明文件，以使用 C 介面 (C-API) 到 Message Queue 訊息服務的功能。

線上說明

Message Queue包括用於執行 Message Queue 訊息服務管理工作的指令行公用程式。若要存取這些公用程式的線上說明，請參閱「共用指令行選項」。

Message Queue 還包括圖形使用者介面 (GUI) 管理工具，即管理主控台 (imqadmin)。上下文關聯的線上說明包括在管理主控台中。

JavaDoc

Message Queue Java 用戶端 API (包括 JMS API) 說明文件的格式為 JavaDoc，它的所在目錄因不同作業系統而異 (請參閱附錄 A「Message Queue 資料的位置」)。

本說明文件可在任何 HTML 瀏覽器 (如 Netscape 或 Internet Explorer) 中檢視。它包括標準的 JMS API 說明文件，以及用於 Message Queue 受管理物件的 Message Queue 特定的 API (請參閱「Message Queue Java 用戶端開發人員指南」的第 3 章)，對訊息傳送應用程式的開發人員很有幫助。

範例用戶端應用程式

大量的範例應用程式提供了範例用戶端應用程式碼，它們的所在目錄位置因作業系統而異 (請參閱附錄 A「Message Queue 資料的位置」附錄)。

請參閱該目錄及其各個子目錄中的 README 檔案。

Java 訊息服務 (JMS) 規格

JMS 規格可在以下位置找到︰

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

規格包括範例用戶端程式碼。

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


備註	Sun 對本文件中所提到之第三方網站資料可用性不負任何責任。Sun 對這類網站或資源中提及的內容、廣告、產品或其他資料的可用性，不做任何保證或負任何責任。Sun 對任何實際或可能的損壞，或者因使用或信任此類網站或資源上可用之內容、商品或服務而造成的損失，不負任何責任或法律責任。

前言