適用於 Microsoft Windows 的 Sun Java System Message Queue 版本說明

適用於 Microsoft Windows 的 Sun Java™ System Message Queue 版本說明

版本 3 2005Q4 (3.6 SP3)

文件號碼 819-5857

此版本說明包括在適用於 Windows 的 Sun Java System Message Queue 3 2005Q4 發行時所提供的重要資訊。其中包括已知的問題與限制以及其他資訊。開始使用 Message Queue 之前，請先閱讀此文件。

您可在 Sun Java System 文件網站 http://docs.sun.com/app/docs/prod/entsys.05q4 和 http://docs.sun.com/app/docs/prod/entsys.05q4?l=zh_TW 找到此版本說明的最新版本。請在安裝與設定軟體之前瀏覽此網站，並定期檢視最新版本說明與產品文件。

此版本說明包含下列各節︰

本文件提供了協力廠商的 URL 及其他相關資訊作為參考。

備註

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

版本說明修訂歷程

表 1 修訂歷程 

日期

對變更的說明

2006 年 2 月

正式版。

2005 年 11 月

後期測試版。

關於 Message Queue 3 2005Q4 (3.6 SP3)

Sun Java System Message Queue 為全方位功能的訊息服務，可提供符合 Java Messaging Specification (JMS) 1.1 的非同步郵件傳送。此外，Message Queue 還提供多種 JMS 規格以外的功能，以滿足大型企業的使用需求。

Message Queue 3 2005Q4 的新增功能

Message Queue 3.6 SP3 2005Q4 (3.6) 的新功能包括：

這些資訊都會在下列的子章節中詳述。

停用訊息佇列

Message Queue 會在代理程式啟動時自動建立專用的目標，以儲存停用的訊息，供診斷之用。停用的訊息是指因一般處理或明確管理員動作以外的原因，從系統中移除的訊息。過期的訊息、因記憶體超限或因傳送失敗而從目標移除的訊息都可稱為停用的訊息。

管理員可將目標配置到放棄的停用訊息，或將其置於停用的訊息佇列。將目標置於停用的訊息佇列時，附加特性資訊會寫入訊息中，向管理員提供訊息停用的原因。用戶端開發者也可以在建立訊息時設定特性值，以便決定要將訊息置於停用的訊息佇列，或者停用該訊息。

如需詳細資訊，請參閱「Message Queue 管理指南」。

無確認模式

NO_ACKNOWLEDGE 確認模式為 JMS API 的延伸。一般而言，代理程式會等候用戶端確認。若用戶端指定 CLIENT_ACKNOWLEDGE，則該確認必須依程式進行，或者若用戶端指定 AUTO_ACKNOWLEDGE 或 DUPS_OK，則可在該階段作業自動進行。若用戶用戶端指定 NO_ACKNOWLEDGE 模式，代理程式會在將其傳送至用戶用戶端的同時，放棄訊息。此功能適合於使用非永久訊息的短期訂閱者，但其他用戶也可以使用。

此功能可降低通訊協定的流量，以及在確認訊息時涵蓋代理程式作業，因此可以提高效能。同時也因為在此功能中，代理程式可處理不確認訊息的行為異常的用戶端，節省代理程式的記憶體資源，因此可以提高效能。您不需費力操作任何程序，即可使用此模式。

C 用戶端不支援 NO_ACKNOWLEDGE 模式。如需詳細資訊，請參閱「Message Queue Developer’s Guide for Java Clients 」。

用戶端訊息內文壓縮

開發者可指定訊息內文為可壓縮。訊息壓縮和解壓縮完全由用戶端在執行階段處理，並不影響代理程式。因此，應用程式在使用此功能時雖可搭配舊版的代理程式，但必須使用版本 3.6 SP3 2005Q4 (3.6) 的 Message Queue 用戶端執行階段程式庫。

壓縮的優點和限制

雖然新版本加入訊息壓縮以提高效能，但不保證一定能帶來任何提高效能的優勢。此優勢視訊息的大小和格式、用戶數量、網路頻寬以及 CPU 效能而定。例如，壓縮和解壓縮的成本可能高於傳送和接收壓縮訊息所節省的時間。在高速網路傳送小型訊息時更是如此。另一方面，發佈大量訊息至多位用戶的應用程式，或在低速網路環境中發佈訊息，壓縮訊息可提高系統效能。

若訊息用戶部署了 3.6 SP3 2005Q4 (3.6) 之前版本的用戶端執行階段程式庫，則無法處理壓縮訊息。設定為傳送壓縮訊息的用戶端必須確定用戶相容。C 用戶端目前無法使用壓縮訊息。

如需詳細資訊，請參閱「Message Queue Developer’s Guide for Java Clients」。

連線失敗偵測 (用戶端執行階段偵測)

Message Queue 3.6 SP3 2005Q4 採用了名為 imqPingInterval 的新 ConnectionFactory 屬性。imqPingInterval 屬性指定從用戶端執行階段至代理程式間 ping 指令的作業頻率。用戶端執行階段可藉由定期測試連線，事先偵測到失敗的連線。若 ping 指令作業失敗，用戶端執行階段會拋出異常至用戶端應用程式的異常偵聽程式物件。若應用程式無異常偵聽程式，應用程式亦無法進行下一步驟的連線。

如需詳細資訊，請參閱「Message Queue 管理指南」。

憑證管理：C-API NSS 工具

C-API 使用 NSS (網路安全性服務) 程式庫支援 SSL。這些程式庫提供開發安全應用程式的 API 和公用程式。這些公用程式包含管理密鑰和憑證資料庫的工具。在 Message Queue 3.5 中，我們要求開發者使用 Mozilla 來管理 NSS 密鑰和憑證。在 Message Queue 3.6 SP3 2005Q4 中，管理員可使用 NSS certutil 工具產生所需的金鑰和憑證。

如需詳細資訊，請參閱「Message Queue Developer’s Guide for C Clients」。

支援 C-API 基本認證

Message Queue 3.6 SP3 2005Q4 C-API 支援基本認證類型。Message Queue 之前的版本不支援基本認證類型。

64 位元 C-API 支援

Message Queue 在 Solaris/SPARC 平台上已可支援 64 位元的 C-API。如需啟用 64 位元 C-API 支援的詳細資訊，請參閱「Message Queue Developer’s Guide for C Clients」。

硬體與軟體需求

本節將指定或說明此版 Message Queue 的硬體與軟體需求。

下表會列出適用於 Windows 作業系統的硬體與軟體需求。

表 2 硬體與軟體需求  

元件

平台需求

作業系統

Windows 2000 Advanced Server SP4 或更新版本
Windows XP Professional Edition SP2
Windows 2003 Enterprise Server

CPU

x86

RAM

256 MB

磁碟空間

100 MB

Message Queue 3.6 SP3 亦須仰賴其他技術，如下表所示。下表會列出並說明開發及執行 Message Queue 用戶端所必須安裝的基本元件。

表 3 Message Queue 3.6 SP3 基本產品支援對照表 

平台/產品

用於

受支援的平台/產品版本

Java Runtime Environment (JRE)

Message Queue 代理程式 (訊息伺服器) 與 Message Queue 管理工具

Java Runtime Environment 1.4.2_05

Java 2 Platform, Standard Edition, 5.0 (1.5.0.04)

Java Software Development Kit (JDK), Standard Edition

開發與部署 Java 用戶端

(Java SOAP/JAXM 用戶端只有在 JDK 1.4.2 和 1.5 中才有受支援)

JDK 1.4.2_05

Java 2 Platform, Standard Edition, 5.0 (1.5.0.04)

下表會列出並說明完成安裝後可以提供 Message Queue 用戶端額外支援的元件。您可能需要安裝其中幾項元件。例如，若您沒有將 C 用戶端寫入 Message Queue，則不需要安裝 C 用戶端支援所需的元件。

表 4 Message Queue 3.6 SP3 選用的產品支援對照表  

產品

用於

受支援的產品版本

LDAP Directory Server

Message Queue 使用者儲存庫與管理物件支援

Sun Java System Directory Server Version 5.2 SP 3

Web Server

HTTP 與 HTTPS 支援

Sun Java System Web Server, Enterprise Edition Version 6.1 SP 4

應用程式伺服器

HTTP 與 HTTPS 支援

Sun Java System Application Server, Enterprise Edition 8.1

資料庫

插接的持續性支援

PointBase 版本 4.8

Oracle 9i 版本 9.2

JNDI

(Java Naming and Directory Interface)

管理物件支援

  • JNDI 版本 1.2.1
  • LDAP Service Provider 版本 1.2.2
  • File System Service Provider 版本 1.2 (可用於開發及測試，但無法部署在生產環境中。)

C 編譯器與相容的 C++ 執行階段程式庫

Message Queue C 用戶端支援

  • Windows：Microsoft Windows Visual C++ 6.0, SP3

NSPR

(Netscape Portable Runtime)

Message Queue C 用戶端支援

Sun Java Enterprise System 2005Q1 隨附的版本

NSS

(Network Security Service)

Message Queue C 用戶端支援

Sun Java Enterprise System 2005Q1 隨附的版本

此版本中已修正的錯誤

表 5 Message Queue 3.6 SP3 2005Q4 中已修正的錯誤

錯誤 ID

說明

6284053

安裝 MQ 時不必要地設定了 CLASSPATH 環境變數

重要資訊

本節涵蓋下列主題：

安裝說明

如需有關修補程式需求及安裝的資訊，請參閱下一節：

修補程式需求資訊

下表為所需修補程式的編號與最低版本。本節所參考之各修補程式皆為升級所需之最低版本編號。本文件發行後，可能已公布新版本的修補程式。較新版之修補程式會在結尾標以不同的版本編號。例如：123456-04 為 123456-02 的新版，但兩者皆使用相同的修補程式 ID。您可以參閱所列各修補程式之 README 檔案中的特殊說明。

如需存取修補程式，請連線至
http://sunsolve.sun.com

表 6 適用於 Windows 的 Message Queue 3.6 SP3 2005Q4 所需修補程式

修補程式編號

修補程式說明

121523-01

Windows (MSI)：共用元件

121533-01

Windows (MSI)： Sun Java?System Message Queue 3.6 SP3 2005Q4

如需有關將 Message Queue 由 JES3 升級為 JES4 的詳細資訊，請參閱「Sun Java Enterprise System 2005Q4 Upgrade Guide for Microsoft Windows」(位於 http://docs.sun.com/app/docs/doc/819-4461)。

與下一個主要 Message Queue 版本相關的問題

Message Queue 的下一主要版本可能會引入新的變更導致您的用戶端與該版本不相容。現在提供這個資訊是為了讓您對這些變更做好準備。

相容性問題

本節涵括 Message Queue 3 2005Q1 (3.6) 中的相容性問題。

Message Queue 3 2005Q1 (3.6) 中的問題

下列各點將說明會對 Windows 平台造成影響的問題。

停用密碼選項

以下選項因安全性考量已停用。

若密碼被指定為指令的一部分，如以下範例所示：

imqcmd query bkr -u admin -p adminpassword

使用者可以在列出或查詢機器程序時看到管理員密碼。請改用 -passfile 選項。「Message Queue 管理指南」中的安全性一章會針對 passfile 選項進行說明。

Message Queue 的文件更新

下列各節會說明 Message Queue 3 2005Q1 (3.6) 及 Message Queue 3 2005Q4 (3.6 SP2) 的文件更新。

Message Queue 3 2005Q1 (3.6) 的文件更新

下列 Message Queue 文件自產品版本 3.5 之後即已更新：

安裝指南

「Message Queue 安裝指南」已更新，以反映產品變更和特定平台的資訊。本文件已將 Message Queue, Platform Edition 的相關安裝資訊涵括在內。

Message Queue, Enterprise Edition 的安裝資訊已移至「Sun Java System 安裝指南」。

如需升級和遷移至 Message Queue 3.6 SP3 2005Q4 (3.6), Enterprise Edition 的相關資訊，請參閱「Sun Java System 升級和遷移指南」。

技術摘要

「Message Queue 技術摘要」為新文件，已在 Message Queue 3 2005Q1 (3.6) 發行版本中介紹過。其已針對 Message Queue 3 2005Q4 (3.6 SP3) 發行版本重新進行編寫。該文件旨在說明 Message Queue 產品、該產品的功能、架構、技術及術語。這本新書含有先前涵括於其他書籍中的概要資訊，為 Message Queue 使用者 (管理員與開發者) 與未來使用者的必備用書。

管理指南

「Message Queue 管理指南」已更新，以反映產品變更與新功能。為了使本文件更加適用於 Message Queue 管理員，已對本文件進行改編。本文件先前包含的概要資訊已移至「Message Queue 技術摘要」。

Message Queue Developer's Guide for Java Clients

「Java Client Developer's Guide 」已更新，以反映產品變更與新功能。本文件也已重新命名為「Message Queue Developer’s Guide for Java Clients」。

「Message Queue Developer’s Guide for Java Clients」為了更加適用於 Message Queue Java 用戶端開發者，已對該指南進行改編。本文件先前包含的概要資訊已移至「Message Queue 技術摘要」。

C Client Developer's Guide

「C Client Developer's Guide」已更新，以反映產品變更和新功能。本文件也已重新命名為「Message Queue Developer’s Guide for C Clients」。

為了更加適用於 Message Queue C 用戶端開發者，「Message Queue Developer’s Guide for C Clients 」已進行改編。本文件先前包含的概要資訊已移至「Message Queue 技術摘要」。

Message Queue 3 2005Q4 (3.6 SP3) Beta 的文件更新

由於 Message Queue 3 2005Q4 (3.6 SP2) Beta 為後期測試版，因此 http://docs.sun.com/coll/1307.1 和 http://docs.sun.com/coll/1421.1 的 Beta 文件集中只會提供自產品版本 3 2005Q1 (3.6) 之後有所更新的文件。如需前一發行版本之後未變更過的文件，請參閱位於 http://docs.sun.com/app/docs/coll/MessageQueue_2005Q1 和 http://docs.sun.com/app/docs/coll/MessageQueue_05q1_zh_TW 的版本 3 2005Q1 (3.6) 文件集。

下列 Message Queue 文件自產品版本 3 2005Q1 (3.6) 之後即已更新：

技術摘要

「Message Queue 技術摘要」為新文件，已在 Message Queue 3 2005Q1 (3.6) 發行版本中介紹過。其已針對 Message Queue 3 2005Q4 (3.6 SP2) 發行版本重新進行編寫。該文件旨在說明 Message Queue 產品、該產品的功能、架構、技術及術語。這本新書含有先前涵括於其他書籍中的概要資訊，為 Message Queue 使用者 (管理員與開發者) 與未來使用者的必備用書。

管理指南

為提供 Message Queue 管理員更好的可用性，已針對「Message Queue 管理指南」進行改編。本文件先前包含的概要資訊已移至「Message Queue 技術摘要」。

Message Queue Developer's Guide for Java Clients

「Message Queue Developer's Guide for Java Clients」新增了「Using the Java API」一章。

為殘障人士提供的無障礙功能

欲獲得此媒體發佈以來已發行的無障礙功能，請向 Sun 索取依據美國「Section 508」法規進行產品評估所得之結果文件，以便決定最適合佈署無障礙功能解決方案的版本。以下網址將提供應用程式的更新版本：
http://sun.com/software/javaenterprisesystem/get.html

如需有關 Sun 在無障礙功能方面之成果的資訊，請至
http://sun.com/access

已知的問題與限制

本節將說明適用於 Microsoft Windows 的 Message Queue 3 2005Q4 的已知問題與限制，涵蓋以下元件範圍：

若要取得目前的錯誤、錯誤狀態以及解決方法的清單，Java Developer Connection™ 成員應參閱 Java Developer Connection 網站上的「Bug Parade」頁。在您報告新的錯誤之前，請先檢視此頁面。儘管此頁面未列出所有的 Message Queue 錯誤，但如果您想知道問題是否已報告，這是個不錯的起點。

相關的網頁為：

若要報告新的錯誤或提交功能請求，請將郵件傳送至 imq-feedback@sun.com。

一般問題

本節包括 Message Queue 3 2005Q1 的一般問題。本節搜羅了 Message Queue Enterprise Edition 相關的問題。

適用於 Enterprise Edition 和 Platform Edition

僅適用於 Enterprise Edition

管理/配置問題

Windows 機器上的 CLASSPATH 若含有雙引號，會導致 imqadmin 與 imqobjmgr 公用程式擲出錯誤 (5060769)

解決方法

您可忽略此錯誤訊息；代理程式會正確地通知用戶任何錯誤。該錯誤不會影響系統的可靠性。

數值中如有空格，所有 solaris/win 程序檔中的 -javahome 選項皆無法運作 (4683029)

Message Queue 指令和公用程式會使用 -javahome 選項指定所要使用的替代 Java 2 相容執行階段。但是，替代 Java 執行階段的路徑必須是不包含空格的路徑。

路徑中有空格的範例如下：

Windows：

C:\jdk 1.4

Solaris：

/work/java 1.4

解決方法

將 Java 執行階段安裝在不含空格的位置或路徑中。

Message Queue 在非 C 語言環境中會對系統記錄檔輸出垃圾訊息 (6193884)

在非 C 語言環境中執行代理程式時，Message Queue 會傳送垃圾輸出到系統記錄檔。

解決方法

在 C 語言環境中執行代理程式。

代理程式問題

在代理程式叢集中，代理程式會將訊息排入遠端連線的佇列中，但該連線可能無法啟動 (4951010)

解決方法

連線啟動之後，用戶便會收到訊息。當用戶關閉連線之後，該訊息會重新傳送至其他用戶。

在 Windows 2000 上，HTTPS createQueueConnection 偶爾會擲出異常 (4953348)

解決方法

重試連線。

使用 Ctrl-C 關閉代理程式時，作業事件可能會在存放區關閉之後清除 (4934446)

如果代理程式在處理訊息或作業事件時關閉，代理程式可能因為「關閉存放區之後存取儲存方法。」原因顯示錯誤。

解決方法

您可忽略此錯誤訊息；代理程式會正確地通知用戶任何錯誤。該錯誤不會影響系統的可靠性。

當永久存放區開啟太多目標時，會導致代理程式無法存取 (4953354)

解決方法

此情況是因為代理程式達到系統開啟檔案描述元的限制所致。請在 Solaris 和 Linux 上使用 ulimit 指令以增加檔案描述元的限制。

銷毀目標會孤立用戶 (5060787)

如果目標已銷毀，作用中的用戶會被孤立。一旦用戶被孤立，則無法再接收訊息 (即使目標重新建立)。

解決方法

此問題並無任何解決方法。

使用 JMSMessageID 的訊息選取無法運作 (6196233)

使用選擇器 "JMSMessageID = '<message_id>'" 的訊息選取無法運作。

  1. 傳送訊息到佇列
  2. 讀取傳送訊息 - <message_id> 的 JMSMessageID。
  3. 在使用選擇器設為 "JMSMessageID = '<message_id>'" 的佇列上建立用戶

    4. 將無法接收訊息。

解決方法

將選擇器從

JMSMessageID = "ID:message-id-string"

變更為

JMSMessageID IN (’ID:message-id-string’, ’message-id-string’)

安裝問題

新增/移除程式控制面板會顯示 Sun Java Enterprise System

新增/移除程式控制面板會列出 Sun Java Enterprise System，而不是 Message Queue。

NSS 和 NSPR 程式庫的位置已變更 (6271133)

NSS 與 NSPR 程式庫的位置已不同於前一版本，「Message Queue C Client Developer's Guide」中有關這些位置的說明可能不正確。這些程式庫是建置 C 用戶端的必要項目；其新位置為「share\lib」資料夾。

例如：C:\Sun\share\lib

檔案 Config_MQ.txt 中含有不正確的資訊

檔案 Config_MQ.txt 中含有不正確的資訊。下列項目會修正部分的錯誤：

嘗試在空間不足的磁碟上進行安裝時，會出現不明的錯誤訊息

在空間不足的磁碟上進行安裝時，安裝會失敗，並會出現不明的錯誤訊息。例如：
「錯誤：-1603 安裝期間發生嚴重錯誤。」

若收到此錯誤訊息，請嘗試在空間足夠的磁碟上進行安裝。

若目錄名稱中含有空格，則無法安裝 MQ (6314103)

例如，C:\Program Files\Sun\MessageQueue

解決方法

請勿將產品安裝在名稱含有空格的目錄下。

若目錄名稱 (如 C:\Software\Sun) 超過 6 個字元，則無法安裝 MQ (6314088、6392963)

例如 C:\Software\sun

解決方法

請勿將產品安裝在名稱超過 6 個字元 (包含磁碟機代號、冒號及斜線) 的目錄下。

SSL

Message Queue C-API SSL 和 MQ_SSL_BROKER_IS_TRUSTED

使用 C-API SSL 連線時，若將 MQ_SSL_BROKER_IS_TRUSTED 設為 MQ_FALSE，則須建立代理程式憑證 (以 CN 為主機名稱，並加上執行中之代理程式完全合格的網域名稱)，並指定與 C-API 應用程式中相同的 MQ_BROKER_HOST_PROPERTY。

若未使用完全合格的網域名稱，則您的代理程式憑證便會遭到拒絕，並傳回錯誤訊息 SSL_ERROR_BAD_CERT_DOMAIN。

解決方法

無

可再分發的檔案

Sun Java System Message Queue 3.6 SP3 2005Q4 包含下列可讓您以二進位格式自由分發的檔案集：

如何報告問題和提供回饋

如果您對 Sun Java System Message Queue 存有任何疑問，請使用以下任一機制與 Sun 客戶支援中心連絡：

為了讓我們可以更好地幫助您解決問題，當您與支援人員連絡時，請準備好以下資訊：

Sun Java System 軟體論壇

關於 Sun Java System Message Queue 的論壇，請至：

我們非常歡迎您加入討論。

Java 技術論壇

Java 技術論壇中有一個或許您會感興趣的 JMS 論壇。

Sun 歡迎您提出寶貴意見

Sun 致力於提高文件品質，因此誠心歡迎您提出意見與建議。

若要提出您的意見，請至 http://docs.sun.com 並按一下[傳送您的回饋意見] (Send Comments)。在線上表格中，請提供文件標題及文件號碼。文件號碼位於書本的標題頁或文件的頂部，通常是一組七位或九位數的數字。例如，本書的書名是「適用於 Microsoft Windows 的 Sun Java System Message Queue 2005Q4 版本說明」，文件號碼為 819-5857。

提出意見時您還需要在表格中輸入此文件的英文標題和文件號碼。例如，本文件的英文文件號碼為 819-4268-10，完整標題為
「Sun Java System Message Queue 2005Q4 Release Notes for Microsoft Windows」。

其他 Sun 資源

您可在下列網際網路位置找到有用的 Sun Java System 資訊：

Copyright © 2006 Sun Microsystems, Inc. 版權所有。

Sun Microsystems, Inc. 對於本文件所述技術擁有智慧財產權。這些智慧財產權包含 http://www.sun.com/patents 上所列的一項或多項美國專利，以及在美國與其他國家/地區擁有的一項或多項其他專利或申請中專利，但並不以此為限。

SUN 專有權/機密。

美國政府權利 - 商業軟體。政府使用者均應遵守 Sun Microsystems, Inc. 的標準授權合約和 FAR 及其增補文件中的適用條款。

應依照授權條款使用。

本發行版本可能包括協力廠商開發的材料。

本產品中的某些部分可能源自加州大學授權的 Berkeley BSD 系統的開發成果。

Sun、Sun Microsystems、Sun 標誌、Java 與 Solaris 是 Sun Microsystems, Inc. 在美國及其他國家/地區的商標或註冊商標。所有 SPARC 商標都是 SPARC International, Inc. 在美國及其他國家/地區的商標或註冊商標，經授權後使用。