![]() | |
Sun Java System Message Queue 3 2005Q1 管理指南 |
第 15 章
實體目標特性參照本章描述您可以為每個實體目標類型設定的特性。您建立或更新實體目標時,可以設定特性值。
針對自動建立的目標,請在代理程式實例配置檔案中設定預設值 (請參閱表 14-4)。
表 15-1 實體目標特性
特性
目標類型
預設值
說明
maxNumMsgs1
佇列主題
-1
(無限制)目標中允許給未使用訊息的最大數目。
停用的訊息佇列的預設值是 1000。
maxTotalMsgBytes1
佇列
主題
-1
(無限制)目標中允許給未使用訊息的最大總記憶體容量 (以位元組為單位)。
停用的訊息佇列的預設值是 10 MB。
limitBehavior
佇列
主題
REJECT_
NEWEST這個字串指定達到記憶體限制臨界值時,代理程式回應的方式。值為:
FLOW_CONTROL - 減緩產生者速度。
REMOVE_OLDEST - 拋出最舊的訊息。
REMOVE_LOW_PRIORITY - 根據訊息存在時間,拋出最後順位的訊息 (生產型用戶端不會收到訊息刪除的通知)。
REJECT_NEWEST - 拒絕最新的訊息。拒絕永久性訊息時,生產型用戶端會發生異常。若要將這個限制運作方式用在非永久性訊息上,請設定 imqAckOnProduce 連線工廠屬性。
如果您將這個特性設定為 REMOVE_OLDEST 或 REMOVE_LOW_PRIORITY,並將目標特性 useDMQ 設定為 true,代理程式會將超過此限制的訊息移動至停用的訊息佇列。
停用的訊息佇列本身有預設限制運作方式 REMOVE_OLDEST,不能設定 FLOW_CONTROL 運作方式,這點與其他目標不同。
maxBytesPerMsg
佇列
主題
-1
(無限制)目標中允許的任何單一訊息的最大容量 (以位元組為單位)。拒絕永久性訊息時,生產型用戶端會發生異常,但拒絕非永久性訊息時則不會收到通知,除非設定 ackOnProduce 特性。
maxNumProducers
佇列
主題
-1
(無限制)允許給目標中產生者的最大數目。達到限制時,將無法建立新的產生者。
您不能為停用的訊息佇列設定這個特性。
maxNumActiveConsumers
僅限佇列
1
最大用戶數目,此數值可作用於來自佇列目標的負載平衡傳送。值 -1 表示沒有限制數目。
Platform Edition 會將此值限制為 2。
maxNumBackupConsumers
僅限佇列
0
最大備份用戶數目,如果無法從佇列目標進行負載平衡傳送,那麼這些用戶可以取代使用中的用戶。值 -1 表示沒有限制數目。
Platform Edition 會將此值限制為 1 (一)。
consumerFlowLimit
佇列
主題
主題: 1000
佇列: 1000
最大訊息數目,這些訊息將會傳送給單一批次中的某個用戶。在負載平衡佇列傳送中,負載平衡開始前,此數目是路由到使用中用戶的佇列訊息初始數目。
目標用戶可以在連線上指定較低值,覆寫這項限制。值 -1 表示沒有限制數目。
localDeliveryPreferred
僅限佇列
false
針對代理程式叢集中的負載平衡佇列傳送,這個布林值指定當本地代理程式沒有用戶時,是否將訊息傳送給遠端用戶。要求目標不僅限於本地傳送 (isLocalOnly = false)。
這個特性不套用於停用的訊息佇列。
isLocalOnly
佇列
主題
false
針對代理程式叢集中的目標,這個布林值指定目標是否限於本地傳送。如果為 true,則其他代理程式上不重複實體目標,且限制目標僅傳送訊息給本地用戶 (連線到有建立目標的代理程式的用戶)。一旦建立目標,即無法變更此特性。
這個特性不套用於停用的訊息佇列。
useDMQ
佇列
主題
true
這個布林值指定是否將停用的訊息傳送至停用的訊息佇列而不捨棄。
這個特性不套用於停用的訊息佇列。
1 在叢集環境中,此特性套用於叢集中的每個目標實例,但整體上,不套用於叢集中的所有實例。