前言

「Sun™ ONE Message Queue (MQ) 3.0.1 管理員指南」這本書提供執行 MQ 訊息傳送系統管理工作所需的背景和資訊。

本前言包含以下各節：

• 本指南的使用者
• 本指南的組織架構
• 慣例
• 其他說明文件資源

本指南的使用者

---

本指南可供需要執行 MQ 管理工作的管理員和應用程式開發人員使用。

MQ 管理員負責設定和管理 MQ 訊息傳送系統，尤其是位於本系統中心的 MQ 訊息伺服器。本書假設您不瞭解訊息傳送系統知識。

本指南還可供應用程式開發人員使用，以使他們更瞭解如何最適化他們的應用程式，從而充分利用 MQ 訊息傳送系統的功能和靈活性。

本指南的組織架構

---

本指南需要您完整閱讀。下表簡要描述了每章的內容：

表格 1    本書內容 

章	描述
第 1 章 「簡介」	描述 MQ 訊息傳送系統以及術語的高級概念簡介。
第 2 章 「MQ 訊息傳送系統」	描述 MQ 訊息傳送系統，重點介紹可共同提供訊息傳送服務的 MQ 代理程式和 MQ 用戶端運行時間。
第 3 章 「MQ 管理」	描述 MQ 管理工作和工具，並介紹用於管理的指令行公用程式及其共用功能。
第 4 章 「管理主控台指導」	提供實用指導，以使您熟悉管理主控台 (即 MQ 訊息伺服器的圖形介面)。
第 5 章 「啟動與配置代理程式」	介紹如何啟動和配置 MQ 代理程式及代理程式叢集。
第 6 章 「代理程式和應用程式管理」	介紹如何執行與管理 MQ 代理程式相關的 (獨立於應用程式) 工作，以及用於管理訊息傳送應用程式的工作。
第 7 章 「管理受管理物件」	介紹如何執行與建立和管理 MQ 受管理物件相關的工作。
第 8 章 「安全性管理」	介紹如何執行與應用程式相關的安全性工作，如管理認證、授權以及加密。
附錄 A 「設定外掛持續性」	介紹如何設定 MQ 以使用 JDBC 相容資料庫來執行持續性功能。
附錄 B 「HTTP/HTTPS 支援 (企業版)」	介紹如何在訊息傳送用戶端與 MQ 訊息伺服器之間設定 HTTP 連線服務。
附錄 C 「將代理程式用作 Windows 服務」	介紹如何使用 MQ 服務管理公用程式 (imqsvcadmin) 來安裝、查詢以及移除代理程式 (作為 Windows 服務執行)。
附錄 D 「MQ 資料的位置」	描述不同種類 MQ 資料的位置。
附錄 E 「MQ 介面的穩定性」	描述不同 MQ 介面的穩定性。
詞彙表	定義 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 根安裝目錄為： Application Server 根安裝目錄/imq。 在 Windows 上，MQ 根安裝目錄由 MQ 安裝程式設定 (依預設，此目錄為 C:\Program Files\Sun Microsystems\Message Queue 3.0.1)。 在 Windows 上，Sun ONE Application Server 的 MQ 根安裝目錄為： Application Server 根安裝目錄/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 1.4) 位置的環境變數： 在 Solaris 上，IMQ_JAVAHOME 預設為 /usr/j2se/jre 目錄，但是，使用者可以選擇性地將值設定為 JRE 1.4 常駐的任意位置。 在 Windows 上，IMQ_JAVAHOME 預設為 IMQ_HOME/jre，但是，使用者可以選擇性地將值設定為 JRE 1.4 常駐的任意位置。 在 Linux 上，IMQ_JAVAHOME 預設為 /usr/java/j2sdk1.0/jre 目錄，但是，使用者可以選擇性地將值設定為 JRE 1.4 常駐的任意位置。

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

其他說明文件資源

---

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

MQ 說明文件集

構成 MQ 說明文件集的說明文件依照一般的使用順序列示在表格 4 中。

表格 4    MQ 說明文件集 

文件	使用者	描述
MQ 安裝指南	開發人員與管理員	介紹如何在 Solaris、Linux 以及 Windows 平台上安裝 MQ 軟體。
版次注意事項	開發人員與管理員	包括對新功能、限制、已知錯誤以及技術說明的描述。
MQ Developer's Guide	開發人員	提供快速啟動指導以及與 JMS MQ 實施相關的程式設計資訊。
MQ 管理員指南	管理員，也建議開發人員使用	提供使用 MQ 管理工具執行管理工作所需的背景與資訊。

線上說明

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

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

JavaDoc

JavaDoc 格式的 JMS 和 MQ API 說明文件可在以下位置提供：

IMQ_HOME/javadoc/index.html
(在 Solaris 上為 /usr/share/javadoc/imq/index.html)

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

範例用戶端應用程式

以下位置中包含一些提供範例用戶端應用程式碼的範例應用程式：

IMQ_HOME/demo (在 Solaris 上為 /usr/demo/imq)

請參閱此目錄及其子目錄中的 README 檔案。

Java 訊息服務 (JMS) 規格

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

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

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