佇列統一資源識別碼 (URI)

佇列的 URI 的開頭是序列 queue://,後面接著:

例如,下列 URI 將連接佇列管理程式 <queue.manager.name> 上的佇列 IN,使所有訊息當做優先順序 5 的 WebSphere MQ 訊息來傳送。

queue://<queue.manager.name>/WC_MQCONN.IN?targetClient=1&priority=5

下列表格顯示佇列 URI 的內容名稱。

表 12. 佇列 URI 的 WebSphere MQ 特定連接器內容名稱
內容名稱 說明
expiry

訊息的使用期限(毫秒)。

0 = 無限。

正整數 = 逾時(毫秒)。

priority

訊息的優先順序。

0-9,其中 1 為最高優先順序。 -1 表示由佇列的配置來決定內容。 -2 指定連接器可使用自己的預設值。

persistence

訊息是否「永久寫入」磁碟。

1 = 不持續

2 = 持續性

-1 表示由佇列的配置來決定內容。 -2 指定連接器可使用自己的預設值。

CCSID

目的地的字集。

整數 - 基本 WebSphere MQ 文件列出之有效值。

targetClient

接收應用程式是否符合 JMS。

0 = JMS(MQRFH2 標頭)

1 = MQ(僅 MQMD 標頭)

encoding

如何代表數值欄位。

基本 WebSphere MQ 文件中說明的整數值。

對於 MQMessages 中的資料,配接器無法控制字集 (CCSID) 或編碼屬性。 因為資料在傳送到訊息緩衝區或從訊息緩衝區擷取的過程中需要進行轉換,所以配接器將依據 JMS 的 IBM WebSphere MQ 實作方式來轉換資料 (請參閱 IBM WebSphere MQ Java 用戶端程式庫文件)。 因此,這些轉換應該是雙向的,相等於原生的 WebSphere MQ API 使用 MQGMO_CONVERT 選項來執行的轉換。

配接器無法控制轉換程序中的差異或失效。 配接器可以擷取 WebSphere MQ 支援的任何 CCSID 或編碼的訊息資料,不需要做任何修改。 若要傳遞特定 CCSID 或編碼的訊息,輸出佇列必須是完整的 URI, 並且指定 CCSIDencoding 的值。 配接器會將這項資訊傳送到 WebSphere MQ,而 WebSphere MQ (透過 JMS API) 在編碼資料以供 MQMessage 遞送使用時會使用這項資訊。

缺少 CCSID 和編碼的支援時,通常可從 IBM 網站下載最新版的 IBM WebSphere MQ Java 用戶端程式庫來解決。若 CCSID 和編碼的問題持續發生,請聯絡「技術支援中心」來討論採用替代「Java 虛擬機器」以執行配接器的可能性。

Copyright IBM Corp. 1997, 2003