佇列的 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);