建立實體目標

若要建立實體目標，請使用 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：指定實體目標中允許未使用訊息的最大數目。

• maxTotalMsgBytes：指定實體目標中允許給未使用訊息的最大總記憶體容量 (以位元組為單位)。

• limitBehavior：指定達到記憶體限制執行緒時，代理程式回應的方式。

• maxBytesPerMsg：指定實體目標中允許的單一訊息最大容量 (以位元組為單位)。

• maxNumProducers：指定實體目標中產生器的最大數目。

• consumerFlowLimit：指定單一批次中，傳送給用戶的最大訊息數目。

• isLocalOnly：僅適用於代理程式叢集。指定在其他代理程式上不複製實體目標，且限制實體目標僅傳送訊息給本機用戶 (即連線到已建立實體目標之代理程式的用戶)。

• useDMQ：指定捨棄實體目標之停用的訊息或放到停用的訊息佇列中。

下列特性僅用於佇列目標：

• maxNumActiveConsumers：指定從佇列目標之負載平衡傳送中可成為使用中用戶的最大數目。

• maxNumBackupConsumers：指定最大備份用戶數目，如果無法從佇列目標進行負載平衡傳送，則這些用戶可以取代使用中用戶。

• localDeliveryPreferred：僅適用於代理程式叢集中的負載平衡佇列傳送。如果本機代理程式沒有用戶，則指定訊息僅傳送給遠端用戶。

如需有關實體目標特性的完整參考資訊，請參閱第 15 章, 實體目標特性參照。

針對自動建立的目標，請在代理程式實例配置檔案中設定預設特性值。表 14–3 中有自動建立特性的參考資訊。