WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 作業系統: Linux, Windows

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

佇列的 URI 指定佇列的名稱,以及選擇性地指定佇列的一或多個內容。

佇列 URI 的開頭為 queue://,後接佇列名稱以及用以設定其餘佇列內容的選用名稱值組清單。

若為 WebSphere MQ 佇列(但非 WebSphere Application Server 預設傳訊提供者佇列), 佇列所在的佇列管理程式可選擇性地指定在佇列之前,並以 / 將佇列管理程式名稱和佇列名稱隔開。

若有指定佇列管理程式,則必須是 XMS 直接連接的佇列管理程式(就使用這個佇列的連線來說), 或者必須是可從這個佇列存取的佇列管理程式。遠端佇列管理程式只支援用來擷取佇列中的訊息, 而不能用來將訊息放在佇列上。完整的詳細說明請參閱 WebSphere MQ 佇列管理程式文件。

如果沒有指定佇列管理程式,則額外的 / 分隔字元為選用的, 有無使用對佇列定義沒有差別。

下列的佇列定義的意義都相同;其中,WebSphere MQ 佇列名為 QB,且位於 XMS 直接連接的 QM_A 佇列管理程式上:

queue://QB
queue:///QB
queue://QM_A/QB

下列範例適用於 C++

ioQueue = session.createQueue("queue:///SYSTEM.DEFAULT.LOCAL.QUEUE");

其中省略了佇列管理程式的名稱。這會解譯成使用 Queue 物件時自屬連線所連接的佇列管理程式。

下列的 C 範例連接佇列管理程式 HOST1.QM1 上的佇列 Q1, 且所有訊息皆在非持續性狀態下傳送,而優先順序為 5:

rc = xmsDestCreate(
  "queue://HOST1.QM1/Q1?persistence=1&priority=5",
  &ioQueue);
相關概念
主題統一資源識別碼 (URI)
暫時目的地
相關參考
Destination(適用於 C 類別)
Destination(適用於 C++ 類別)
IDestination(適用於 .NET 介面)
Destination 內容

Concept topic

使用條款 | 評比此網頁

時間戳記前次更新: 25 Apr 2006
(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)