Sun Java System Message Queue 3.7 UR1 技術摘要

前言

本書「Sun Java System Message Queue 3.7 UR1 技術摘要」提供關於 Message Queue 訊息傳送服務的技術、概念、架構、功能以及特色等介紹。

因此，在 Message Queue 文件集中，本書為其他書籍的基礎，應優先閱讀。

本書適用對象

本書適用於應用程式開發者、管理員與其他計劃使用 Message Queue 產品的使用者，或是希望瞭解其產品技術、概念、架構、功能以及特色的使用者。

應用程式開發者需負責撰寫使用 Message Queue 服務的 Message Queue 用戶端應用程式，以便與其他用戶端應用程式交換訊息。
管理員必須負責設定及管理 Message Queue 訊息傳送服務。本書假設您不瞭解訊息傳送系統知識。

本書假設您不瞭解 Java Message Service (JMS) 規格 (由 Message Queue 服務實作)。

閱讀本書之前

閱讀本書沒有任何先決條件。閱讀 Message Queue 開發者指南與管理指南之前，應先閱讀本書以瞭解 Message Queue 的基本概念。

本書架構

本書的設計原意是從頭到尾順序閱讀；每一章都是以之前章節中包含的資訊為基礎進行說明。下表簡要描述各章的內容：

表 P–1 本書內容與架構


章節	說明
第 1 章, 訊息傳送系統：簡介	介紹訊息傳送中介軟體技術、討論 JMS 標準，以及說明 Message Queue 服務如何實作該項標準。
第 2 章, 用戶端程式設計模型	說明 JMS 程式設計模型，以及應如何使用 Message Queue 用戶端執行階段來建立 JMS 用戶端。說明對於 C++ 用戶端和 SOAP 訊息傳輸的執行階段支援。
第 3 章, Message Queue 服務	討論管理作業與工具，並說明用來配置連線、路由、永久性、安全性和監視的代理程式服務。
第 4 章, 代理程式叢集	討論 Message Queue 代理程式叢集的架構及使用。
第 5 章, Message Queue 和 J2EE	探索在 J2EE 平台環境中實作 JMS 支援的結果。
附錄 A選擇性 JMS 功能的 Message Queue 實作	說明 Message Queue 產品如何處理 JMS 可選項目。
附錄 BMessage Queue 功能	列出 Message Queue 功能、總結這些功能的實作步驟，並提供參照以便獲得進一步資訊。
字彙表	提供使用 Message Queue 時，可能遇到的專有名詞和概念的資訊。

相關文件

Message Queue 文件集所包含的文件依照一般使用順序列於下表。

表 P–2 Message Queue 文件集


文件	使用者	說明
「Sun Java System Message Queue 3.7 UR1 Installation Guide」	開發者與管理員	解釋如何在 Solaris、Linux 及 Windows 平台上安裝 Message Queue 軟體。
「Sun Java System Message Queue 3.7 UR1 版本說明」	開發者與管理員	包括對新功能、限定、已知錯誤以及技術性注意事項的描述。
「Sun Java System Message Queue 3.7 UR1 技術摘要」	開發者與管理員	介紹 Message Queue 概念、功能及元件。
「Sun Java System Message Queue 3.7 UR1 Developer’s Guide for Java Clients」	開發者	為使用 Message Queue 實作 JMS 或 SOAP/JAXM API 的 Java 用戶端程式開發者，提供快速入門教學和程式設計資訊。
「Sun Java System Message Queue 3.7 UR1 管理指南」	管理員，也適用於開發者	提供使用 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 還包括圖形化使用者介面 (GUI) 管理工具，即管理主控台 (imqadmin)。管理主控台中包含上下文相關的說明；請參閱「Sun Java System Message Queue 3.7 UR1 管理指南」中的「管理主控台線上說明」。

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 Message Service (JMS) 規格

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

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

目錄變數慣例

Message Queue 使用 3 個目錄變數，這些變數的設定方式因平台而異。表 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`	用於 Message Queue 文件，表示 Message Queue 基底目錄 (根安裝目錄)：在 Solaris 和 Linux 上，沒有根 Message Queue 安裝目錄。因此，Message Queue 文件未使用 `IMQ_HOME` 表示 Solaris 和 Linux 的檔案位置。在 Windows 上，根 Message Queue 安裝目錄是設定在 Message Queue 束解壓縮的目錄。
`IMQ_VARHOME`	儲存 Message Queue 暫存檔或動態建立配置檔與資料檔的 `/var` 目錄。可以將其設定為指向任何目錄的環境變數。在 Solaris 上，`IMQ_VARHOME` 預設為 `/var/imq` 目錄。在 Solaris 上，針對 Sun Java System Application Server, Evaluation Edition，`IMQ_VARHOME` 預設為 `IMQ_HOME/var` 目錄。在 Linux 上，`IMQ_VARHOME` 預設為 `/var/opt/sun/mq` 目錄。在 Windows 上，`IMQ_VARHOME` 預設為 `IMQ_HOME/var` 目錄。
`IMQ_JAVAHOME`	指向 Message Queue 可執行檔所需 Java 執行階段環境 (JRE) 位置的環境變數：在 Solaris 上，`IMQ_JAVAHOME` 會尋找最新的 JDK，但是使用者可選擇將該值設定為任何喜好的 JRE 所在位置。在 Linux 上，Message Queue 會先尋找最新的 JDK，但是使用者可選擇將 `IMQ_JAVAHOME` 值設定為任何喜好的 JRE 所在位置。在 Windows 上，`IMQ_JAVAHOME` 會設定為指向現有 Java 執行階段 (如果在系統上找到支援的版本)。如果找不到支援的版本，則會安裝一個支援的執行階段。

在本書中，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	書籍標題、新術語與要強調的字詞	請參閱「使用者指南」中的第 6 章。快取是指本機儲存的副本。請勿儲存此檔案。備註：某些強調的項目線上顯示為粗體。

指令範例中的 Shell 提示符號

下表列出針對 C shell、Bourne shell、Korn shell 及 Windows 作業系統，預設的 UNIX® 系統提示符號及超級使用者提示符號。

表 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	同時按下 Ctrl 鍵和 A 鍵。
+	連續按下多個按鍵。	Ctrl+A+N	按下 Ctrl 鍵再放開，然後按下後續的按鍵。
->	表示圖形化使用者介面的功能表項目選取。	[檔案] -> [新增] -> [範本]	從 [檔案] 功能表中，選擇 [新增]。從 [新增] 子功能表中，選擇 [範本]。

文件、支援和培訓

Sun 網站提供下列其他資源的相關資訊：

文件 (http://www.sun.com/documentation/)
支援 (http://www.sun.com/support/)
培訓 (http://www.sun.com/training/)

搜尋 Sun 產品文件

除了從 docs.sun.com 網站搜尋 Sun 產品文件之外，您可以使用搜尋引擎，在搜尋欄位中輸入下列語法：

search-term site:docs.sun.com

例如，若要搜尋「broker」，請如下輸入：

broker site:docs.sun.com

若要在搜尋中包含其他 Sun 網站 (例如 java.sun.com、www.sun.com 和 developers.sun.com)，請在搜尋欄位中使用「sun.com」，而非「docs.sun.com」。

協力廠商網站參照

本文件中提供了協力廠商 URL 以供參考，另亦提供其他相關的資訊。

備註 –

Sun 對本文件中提到的協力廠商網站的可用性不承擔任何責任。對於此類網站或資源中的 (或透過它們所取得的) 任何內容、廣告、產品或其他材料，Sun 並不表示認可，也不承擔任何責任。對於因使用或依靠此類網站或資源中的 (或透過它們所取得的) 任何內容、產品或服務而造成的、名義上造成的或連帶產生的任何實際或名義上之損壞或損失，Sun 概不負責，也不承擔任何責任。

Sun 歡迎您提出寶貴意見

Sun 致力於提高文件品質，因此誠心歡迎您提出意見與建議。若要分享您的意見，請至 http://docs.sun.com，並按一下 [Send Comments (傳送您的意見)]。在線上表單中，請提供完整的文件標題和文件號碼。文件號碼是一個七位或九位的數字，可以在書的標題頁面或文件的 URL 中找到。例如，本書的文件號碼為 820-0534。

在您提出意見時，可能需要在表單中輸入英文版書名和文件號碼，本書的英文版文件號碼和書名為：819-4470 和「Sun Java System Message Queue 3.7 UR1 Technical Overview」。