若要建立實體目標,請使用 imqcmd create 子指令。create 子指令的語法如下:
create dst -t destType -n destName [-o property=value ] [-o property=value1] …
例如,若要建立佇列目標,請輸入以下指令:
imqcmd create dst -n myQueue -t q -o “maxNumActiveConsumers=5” |
若要建立主題目標,請輸入以下指令:
imqcmd create dst -n myTopic -t t -o “maxBytesPerMsg=5000” |
建立實體目標時,您必須指定以下項目:
實體目標類型 t (topic) 或 q (queue)。
實體目標名稱。命名規則如下:
名稱只能使用字母數字字元。不能包含空格。
名稱可以用英文字母字元、底線字元 (_) 或錢幣符號 ($) 開頭。不能以 mq 字元字串開頭。
實體目標特性的非預設值。
更新實體目標時,您也可以設定特性。
很多實體目標特性都會影響代理程式記憶體資源和訊息流量。例如,您可以指定能夠傳給實體目標的產生器數目、產生器可以傳送的訊息數量和容量,以及到達實體目標限制時代理程式的回應方式。這些限制類似於代理程式配置特性所控制的一切代理程式限制。
下列特性可用於佇列目標和主題目標:
maxNumMsgs:指定實體目標中允許未使用訊息的最大數目。
maxBytesPerMsg:指定實體目標中允許的單一訊息最大容量 (以位元組為單位)。
isLocalOnly:僅適用於代理程式叢集。指定在其他代理程式上不複製實體目標,且限制實體目標僅傳送訊息給本機用戶 (即連線到已建立實體目標之代理程式的用戶)。
useDMQ:指定捨棄實體目標之停用的訊息或放到停用的訊息佇列中。
下列特性僅用於佇列目標:
maxNumBackupConsumers:指定最大備份用戶數目,如果無法從佇列目標進行負載平衡傳送,則這些用戶可以取代使用中用戶。
localDeliveryPreferred:僅適用於代理程式叢集中的負載平衡佇列傳送。如果本機代理程式沒有用戶,則指定訊息僅傳送給遠端用戶。
如需有關實體目標特性的完整參考資訊,請參閱第 15 章, 實體目標特性參照。
針對自動建立的目標,請在代理程式實例配置檔案中設定預設特性值。表 14–3 中有自動建立特性的參考資訊。