前言
本「Sun Java SystemTM Message Queue 管理指南」為系統管理員提供設定和管理 Sun Java System Message QueueTM 訊息傳送系統時所需的背景和資訊。
本書適用對象
本手冊適用於需要執行 Message Queue 管理作業的管理員和應用程式開發者。Message Queue 管理員負責設定和管理 Message Queue 訊息傳送系統，尤其是處於系統核心地位的訊息代理程式。
閱讀本書之前
閱讀本手冊之前，應先閱讀「Sun Java System Message Queue 3.7 UR1 技術摘要」，以熟悉 Java 訊息服務規格之 Message Queue 實作、Message Queue 服務的元件，以及開發、部署和管理 Message Queue 應用程式的基本程序。
本書架構
表 P–1 描述本手冊的內容。
表 P–1 本手冊的內容|
部份/章節 |
說明 |
|---|---|
|
介紹 Message Queue 管理作業和工具。 |
|
|
提供實用指導，讓您熟悉 Message Queue 管理主控台。 |
|
|
描述如何啟動 Message Queue 代理程式和用戶端。 |
|
|
描述如何設定及讀取配置特性，並介紹代理程式的可配置內容。此外，還描述如何設定檔案或資料庫以執行永久性功能。 |
|
|
描述代理程式管理作業。 |
|
|
描述與實體目標相關的管理作業。 |
|
|
描述與安全性相關的作業，例如管理密碼檔案、認證、授權和加密。 |
|
|
描述物件存放區，並說明如何執行與受管理物件 (連線工廠和目標) 相關的作業。 |
|
|
描述如何設定及管理 Message Queue 代理程式叢集。 |
|
|
描述如何設定及使用 Message Queue 監視設備。 |
|
|
描述分析與最佳化訊息服務效能的技術。 |
|
|
提供判斷一般 Message Queue 問題成因和解決方法的建議。 |
|
|
提供 Message Queue 指令行公用程式的語法和說明。 |
|
|
描述 Message Queue 訊息代理程式的配置特性。 |
|
|
描述實體目標的配置特性。 |
|
|
描述受管理物件 (連線工廠和目標) 的配置特性。 |
|
|
描述可搭配應用程式伺服器使用之 Message Queue 資源介面的配置特性。 |
|
|
描述 Message Queue 訊息代理程式可提供用於監視、調校和診斷用途的度量資訊。 |
|
|
列出每個支援平台上的 Message Queue 檔案位置。 |
|
|
描述不同 Message Queue 介面的穩定性。 |
|
|
描述如何設定及使用超文字傳輸協定 (HTTP ) 進行 Message Queue 通訊。 |
|
|
列出某些常用的 Message Queue 指令公用程式 (imqcmd) 指令。 |
|
相關文件
Message Queue 文件集所包含的文件依照一般使用順序列於下表。
表 P–2 Message Queue 文件集|
文件 |
使用者 |
說明 |
|---|---|---|
|
開發者與管理員 |
解釋如何在 Solaris、Linux 及 Windows 平台上安裝 Message Queue 軟體。 |
|
|
開發者與管理員 |
包括對新功能、限定、已知錯誤以及技術性注意事項的描述。 |
|
|
開發者與管理員 |
介紹 Message Queue 概念、功能及元件。 |
|
|
「Sun Java System Message Queue 3.7 UR1 Developer’s Guide for Java Clients」 |
開發者 |
為使用 Message Queue 實作 JMS 或 SOAP/JAXM API 的 Java 用戶端程式開發者，提供快速入門教學和程式設計資訊。 |
|
管理員，也適用於開發者 |
提供使用 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)。管理主控台中包含上下文相關的說明；請參閱管理主控台線上說明。
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、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 |
書籍標題、新術語與要強調的字詞 |
請參閱User's Guide 中的第 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 網站提供下列其他資源的相關資訊：
搜尋 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-0844。
在您提出意見時，可能需要在表單中輸入英文版書名和文件號碼，本書的英文版文件號碼和書名為：819-4467 和「Sun Java SystemMessageQueue 3.7 UR1 Administration Guide」。
- © 2010, Oracle Corporation and/or its affiliates