|
| |
| Sun Java System Message Queue 3 2005Q1 管理指南 | |
第 15 章
物理目标属性参考本章介绍可为各种类型物理目标设置的属性。可在创建或更新物理目标时设置属性值。
对于自动创建的目标，可以在代理的实例配置文件中设置默认值（请参见表 14-4）。
表 15-1 物理目标属性
属性
目标
类型默认值
说明
maxNumMsgs1
队列主题
-1
（无限制）目标中允许的未使用消息的最大数量。
对于停用消息队列，默认值是 1000。
maxTotalMsgBytes1
队列主题
-1
（无限制）目标中未使用消息允许占用的内存的最大总量（以字节为单位）。
对于停用消息队列，默认值是 10 兆字节。
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 表示不限制数量。
平台版将此值限制为 2。
maxNumBackupConsumers
仅限队列
0
在出现从队列目标的负荷平衡传送错误时，代替这些活动使用方的最大备份使用方数量。值为 -1 表示不限制数量。
平台版将此值限制为 1（一）。
consumerFlowLimit
队列主题
主题： 1000
队列： 1000
将要在一批中传送给使用方的消息的最大数量。在负荷平衡队列传送中，为负荷平衡开始之前路由至活动使用方的队列消息的初始数量。
目标使用方可以通过在连接中指定一个较小的值来覆盖此限制。值为 -1 表示不限制数量。
localDeliveryPreferred
仅限队列
false
一个布尔值（适用于代理群集中的负荷平衡队列传送），指定是否仅当本地代理中没有使用方时才将消息传送到远程使用方。要求目标不限于仅本地传送 (isLocalOnly = false)。
此属性不适用于停用消息队列。
isLocalOnly
队列主题
false
一个布尔值（适用于队列群集中的目标），指定是否将目标限制为仅本地传送。如果为 true，则不能在其他代理上复制目标，并限制只将消息传送到本地使用方（连接到创建目标的代理的使用方）。在创建目标后，无法更改此属性。
此属性不适用于停用消息队列。
useDMQ
队列主题
true
一个布尔值，指定是否应将停用消息发送到停用消息队列中，而不是将其废弃。
此属性不适用于停用消息队列。
1 在群集环境中，此属性将应用于群集中每个目标实例中，而不是应用到群集中的所有实例。