佇列的 URI 的開頭是序列 queue://,後面接著:
- 存放佇列的佇列管理程式名稱
- 另一個 /
- 佇列的名稱
- 用來設定剩餘佇列內容的名稱/值組清單(可選用的)。
例如,下列 URI 將連接佇列管理程式
crossworlds.queue.manager 上的佇列 IN,
並使所有訊息以優先順序 5 的 WebSphere MQ 訊息來傳送。
queue://crossworlds.queue.manager/MQCONN.IN?targetClient=1&priority=5
下表顯示佇列 URI 的內容名稱。
內容名稱
| 說明
| 值
|
expiry
| 訊息的使用期限(毫秒)。
| 0 = 無限。 正整數 = 逾時(毫秒)。
|
priority
| 訊息的優先順序。
| 0-9,其中 1 為最高優先順序。 -1 表示由佇列的配置來決定內容。 -2
指定連接器可使用自己的預設值。
|
persistence
| 訊息是否「永久寫入」磁碟。
| 1 = 非持續性 2 = 持續性。-1 值表示應該由佇列的配置來決定內容。-2
指定連接器可使用自己的預設值。
|
CCSID
| 離埠訊息的字集編碼。
| 整數 - 基本 WebSphere MQ 文件列出之有效值。 此值應該與 CCSID
連接器特有配置內容相符;請參閱CCSID。
|
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, 並且指定 CCSID 和
encoding 的值。 連接器會將此資訊傳送到 WebSphere MQ,而 WebSphere
MQ (透過 JMS API) 在編碼資料以進行 MQMessage 遞送時會使用此資訊。 缺少 CCSID
和編碼的支援時,通常可從 IBM 網站下載最新版的 IBM WebSphere MQ Java
用戶端程式庫來解決。若 CCSID 和編碼特有的問題持續發生, 請聯絡 WebSphere
商業整合系統「技術支援中心」,來討論採用替代性「Java
虛擬機器」執行連接器的可能性。
