test

Sun Java System Message Queue 3.7 UR1 管理指南

第 14 章 代理属性参考

本章提供了有关消息代理配置属性 的参考信息。本章包含以下各节：

连接属性

表 14–1 中列出了与连接服务相关的代理属性。

表 14–1 代理连接属性

属性 

类型 

默认值 

描述 

imq.service.activelist

字符串 

jms,admin

代理启动时将激活的连接服务的列表，用逗号分隔

imq.hostname

字符串 

所有可用的 IP 地址 

所有连接服务的默认主机名或 IP 地址

imq.portmapper.hostname

字符串 

无 

端口映射器的主机名或 IP 地址

如果指定，将覆盖 imq.hostname。

imq.portmapper.port [可用于 imqcmd update bkr 命令]

整数 

7676

端口映射器的端口号 

注 –

如果多个代理实例在同一台主机上运行，则必须为每个实例指定一个唯一的端口映射器端口。

imq.serviceName .protocolType.hostname [仅限于 jms、ssljms、admin 和 ssladmin 服务；有关配置 httpjms 和 httpsjms 服务的信息，请参见附录 C，HTTP/HTTPS 支持。 ]

字符串 

无 

连接服务的主机名或 IP 地址

如果指定，将覆盖指定连接服务的 imq.hostname。

imq.serviceName .protocolType.port

整数 

0

连接服务的端口号 

值为 0 表示应当由端口映射器动态分配端口号。

imq.portmapper.backlog

整数 

50

操作系统后备队列中处于待处理状态的端口映射器请求的最大数量。 

imq.serviceName .threadpool_model [仅限于 jms 和 admin 服务]

字符串 

dedicated

线程池管理的线程处理模型： 

    dedicated：每个连接有两个专用线程，一个用于传入消息，另一个用于传出消息


    shared：在发送或接收消息时，连接由共享线程处理
     

专用模型会限制可以支持的连接数，但能提供较高的性能；共享模型可以增加可用连接数，但由于线程管理需要额外的开销，因此会导致性能下降。 

imq.serviceName .min_threads

整数 

jms：10 ssljms ：10 httpjms：10 httpsjms：10 admin：4 ssladmin：4

连接服务的线程池中维护的最小线程数 

当可用线程数超出此阈值时，将会关闭空闲线程，直到达到最小线程数。 

如表中所示，默认值因连接服务而异。 

imq.serviceName .max_threads

整数 

jms：1000 ssljms：500 httpjms：500 httpsjms ：500 admin：10 ssladmin：10

线程数量达到该数量后，新的线程将不会被添加到线程池中供命名的连接服务使用 

该数必须大于 0，并且必须大于 imq.serviceName.min_threads 的值。

如表中所示，默认值因连接服务而异。 

imq.shared.connectionMonitor_limit [仅适用于共享线程处理模型。]

整数 

Solaris：512 Linux：512 Windows：64

分配器线程监视的最大连接数 

系统会分配足够多的分配器线程来监视所有连接。此属性的值越小，为活动连接指定线程的速度越快。值为 -1 表示不限制每个线程的连接数。

如表中所示，默认值因操作系统平台而异。 

imq.ping.interval

整数 

120

测试客户端与代理之间的连接的时间间隔（以秒为单位） 

如果值为 0 或 -1，将禁止定期测试连接。

路由属性

表 14–2 中列出了与路由服务相关的代理属性。表 14–3 中列出了用于配置目的地自动创建功能的属性。

表 14–2 代理路由属性

属性 

类型 

默认值 

描述 

imq.system.max_count [可用于 imqcmd update bkr 命令]

整数 

-1

代理保存的最大消息数 

值为 -1 表示不限制消息数量。

imq.system.max_size

字符串 

-1

代理保存的消息总量的最大值 

可以使用以下后缀（分别表示字节、千字节或兆字节）来表示该值： 

    b：字节


    k：千字节（1024 字节）


    m：兆字节（1024 x 1024 = 1,048,576 字节）
     

不带后缀的值用字节表示；值为 -1 表示不限制消息容量。
     

示例：

    1600：1600 字节


    1600b：1600 字节


    16k：16 千字节（= 16,384 字节）


    16m：16 兆字节（= 16,777,216 字节）


    -1：无限制

imq.message.max_size

字符串 

70m

单个消息主体的最大大小 

语法与 imq.system.max_size 的语法相同（请参见上文）。

imq.message.expiration.interval

整数 

60

回收过期消息的时间间隔（以秒为单位） 

imq.resourceState .threshold

整数 

green：0 yellow：80 orange：90 red：98

触发内存资源状态的占用百分比（其中 resourceState 为 green、yellow、 orange 或 red）

imq.resourceState .count

整数 

green：5000 yellow：500 orange：50 red：0

在检查是否达到内存资源状态阈值之前，允许在一批中传入的最大消息数（其中 resourceState 为 green、yellow、orange 或 red）

当系统内存越来越不足时，此限制可以限制消息生成方的数量。 

imq.destination.DMQ.truncateBody

布尔值 

false

在消息主体存储到停用消息队列之前是否将其删除？ 

如果为 true，则仅保存消息头和属性数据。

imq.transaction.autorollback

布尔值 

false

是否自动回滚在代理启动时处于 PREPARED 状态的分布式事务？ 

如果为 false，则必须使用命令实用程序 (imqcmd) 手动提交或回滚事务。

表 14–3 自动创建目的地的代理属性

属性 

类型 

默认值 

描述 

imq.autocreate.queue [可用于 imqcmd update bkr 命令] , [仅限于队列目的地。]

布尔值 

true

是否允许自动创建队列目的地？ 

imq.autocreate.topic [仅限于主题目的地]

布尔值 

true

是否允许自动创建主题目的地？ 

imq.autocreate.destination.maxNumMsgs

整数 

100000

未使用消息的最大数量 

值为 -1 表示不限制消息数量。

imq.autocreate.destination.maxBytesPerMsg

字符串 

10k

任何单条消息的最大大小（以字节为单位） 

可以使用以下后缀（分别表示字节、千字节或兆字节）来表示该值： 

    b：字节


    k：千字节（1024 字节）


    m：兆字节（1024 x 1024 = 1,048,576 字节）
     

不带后缀的值用字节表示；值为 -1 表示不限制消息大小。
     

示例：

    1600：1600 字节


    1600b：1600 字节


    16k：16 千字节（= 16,384 字节）


    16m：16 兆字节（= 16,777,216 字节）


    -1：无限制

imq.autocreate.destination.maxTotalMsgBytes

字符串 

10m

未使用的消息最多可以占用的内存总量（以字节为单位）

语法与 imq.autocreate.destination.maxBytesPerMsg 的语法相同（请参见上文）。

imq.autocreate.destination.limitBehavior

字符串 

REJECT_NEWEST

达到内存限制的阈值时，代理的行为如下： 

    FLOW_CONTROL：降低生成方速度


    REMOVE_OLDEST：丢弃最旧的消息


    REMOVE_LOW_PRIORITY：根据消息的存留期丢弃优先级最低的消息；生成方客户端不会收到通知


    REJECT_NEWEST：拒绝最新的消息；仅当消息为持久性消息时，才通知生成方客户端，并报告异常
     

如果值为 REMOVE_OLDEST 或 REMOVE_LOW_PRIORITY ，且 imq.autocreate.destination.useDMQ 属性为 true，则会将超出限制的消息移动到停用消息队列中。

imq.autocreate.destination.maxNumProducers

整数 

100

目的地的消息生成方的最大数量

当达到此限制时，将无法创建新的生成方。值为 -1 表示不限制生成方数量。

imq.autocreate.queue.maxNumActiveConsumers

整数 

1

在来自队列目的地的负载平衡传送中活动消息使用方的最大数量

值为 -1 表示不限制使用方数量。

imq.autocreate.queue.maxNumBackupConsumers

整数 

0

在来自队列目的地的负载平衡传送中备份消息使用方的最大数量

值为 -1 表示不限制生成方数量。

imq.autocreate.queue.consumerFlowLimit

整数 

1000

在一批中传送给队列使用方的消息的最大数量

在负载平衡队列传送中，该值为负载平衡开始之前路由至活动使用方的队列消息的初始数量。目的地使用方可以通过在连接中指定一个较小的值来覆盖此限制。 

值为 -1 表示不限制消息数量。

imq.autocreate.topic.consumerFlowLimit

整数 

1000

在一批中传送给主题使用方的消息的最大数量

值为 -1 表示不限制使用方数量。

imq.autocreate.destination.isLocalOnly

布尔值 

false

仅限本地传送？ 

此属性仅适用于代理群集中的目的地，目的地一旦创建，此属性即无法更改。如果为 true，将不在其他代理上复制目的地，并将目的地限制为只将消息传送到本地使用方（那些连接到创建该目的地的代理的使用方）。

imq.autocreate.queue.localDeliveryPreferred

布尔值 

false

是否首选本地传送？ 

此属性仅适用于代理群集中的负载平衡队列传送。如果为 true，则只有在本地代理中不存在使用方时，才会将消息传送给远程使用方；不得将目的地限制为仅本地传送（imq.autocreate.destination.isLocalOnly 必须为 false）。

imq.autocreate.destination.useDMQ

布尔值 

true

是否将停用消息发送到停用消息队列？ 

如果为 false，将仅仅丢弃停用消息。

持久性属性

Message QueueTM 支持使用基于文件和基于 JDBC 的模型来存储持久性数据。代理属性 imq.persist.store（表 14–4）指定要使用的模型。以下各节介绍了这两种模型的代理配置属性。

表 14–4 全局代理持久性属性

属性 

类型 

默认值 

描述 

imq.persist.store

字符串 

file

持久性数据存储库模型： 

    file：基于文件的持久性


    jdbc：基于 JDBC 的持久性

基于文件的持久性

表 14–5 中列出了与基于文件的持久性相关的代理属性。

表 14–5 基于文件持久性的代理属性

属性 

类型 

默认值 

描述 

imq.persist.file.message.max_record_size

字符串 

1m

要添加到消息存储文件中的消息的最大大小。 

超出此大小的所有消息都将存储到其自身的单独文件中。 

可以使用以下后缀（分别表示字节、千字节或兆字节）来表示该值： 

    b：字节


    k：千字节（1024 字节）


    m：兆字节（1024 x 1024 = 1,048,576 字节）


不带后缀的值用字节表示。 

示例：

    1600：1600 字节


    1600b：1600 字节


    16k：16 千字节（= 16,384 字节）


    16m：16 兆字节（= 16,777,216 字节）

imq.persist.file.destination.message.filepool.limit

整数 

100

目的地文件池中可重复使用的最大空闲文件数。 

超出此限制的空闲文件将被删除。代理将根据需要创建文件或删除超出限制的多余文件。 

此限制越高，代理处理持久性数据的速度越快。 

imq.persist.file.message.filepool.cleanratio

整数 

0

空闲文件池中将保持清除（清空）状态的文件的百分比。 

此值越大，文件池所需的磁盘空间越少，但在操作中清除文件所需的开销越大。 

imq.persist.file.message.cleanup

布尔值 

false

是否在关闭时清除空闲的文件池中的文件？ 

将此属性设置为 true 可以节省用于文件存储的磁盘空间，但会降低代理关闭的速度。

imq.persist.file.sync.enabled

布尔值 

false

是否将内存中的状态与物理存储设备同步？ 

将此属性设置为 true 可以避免因系统崩溃引起的数据丢失，但性能会有所下降。

注 –

如果为 Message Queue 运行 Sun Cluster 和 Sun Cluster Data Service，请将所有群集节点上的代理的此属性设置为 true。

基于 JDBC 的持久性

表 14–6 中列出了与基于 JDBC 的持久性相关的代理属性。给出的示例适用于 DataMirror Mobile Solutions, Inc. 提供的 PointBase® 数据库产品系列。

表 14–6 基于 JDBC 持久性的代理属性

属性 

示例 

描述 

imq.persist.jdbc.brokerid

PointBase 嵌入式版本不需要 

（可选）代理实例标识符

必须是字母数字字符串，不能超过 n - 12 个字符，其中 n 是数据库允许的最大表名长度。

此标识符将附加到数据库表名之后，当多个代理实例使用同一个数据库作为持久性数据存储库时，此标识符可以使数据库表名保持唯一。嵌入式数据库只存储一个代理实例的数据，因此通常不需要该标识符。 

imq.persist.jdbc.driver

com.pointbase.jdbc.jdbcUniversalDriver

用于连接到数据库的 JDBC 驱动程序的 Java 类名

imq.persist.jdbc.opendburl

jdbc:pointbase:embedded:dbName ; 

    database.home=

       .../instances/
instanceName/dbstore

用于打开现有数据库连接的 URL

imq.persist.jdbc.createdburl

jdbc:pointbase:embedded:dbName ; 

    new,database.home=

       .../instances/
instanceName/dbstore

（可选）用于创建新数据库的 URL

仅在使用 Message Queue 数据库管理器实用程序 (imqdbmgr) 创建数据库时才需要此属性。

imq.persist.jdbc.closedburl

PointBase 不需要 

（可选）用于关闭数据库连接的 URL

imq.persist.jdbc.user

 

（可选）用于打开数据库连接的用户名（如果需要）

出于安全原因，可以指定该值，而不使用命令行选项 imqbrokerd -dbuser 和 imqdbmgr - u。

imq.persist.jdbc.needpassword

 

（可选）数据库是否要求为代理访问输入密码？

如果为 true，则imqbrokerd 和 imqdbmgr 命令将提示输入密码，除非您使用 -passfile 选项指定包含密码的密码文件。

imq.persist.jdbc.password [应仅在密码文件中使用]

 

（可选）用于打开数据库连接的密码

imq.persist.jdbc.table.IMQSV35

CREATE TABLE ${name} 

    (STOREVERSION INTEGER NOT NULL,

     
BROKERID VARCHAR(100))

用于创建版本表的 SQL 命令

imq.persist.jdbc.table.IMQCCREC35

CREATE TABLE ${name} 

    (RECORDTIME BIGINT NOT NULL,

     
RECORD BLOB(10k))

用于创建配置更改记录表的 SQL 命令

imq.persist.jdbc.table.IMQDEST35

CREATE TABLE ${name} 

    (DID VARCHAR(100) NOT NULL,

     
DEST BLOB(10k),

     primaryKey(DID))

用于创建目的地表的 SQL 命令

imq.persist.jdbc.table.IMQINT35

CREATE TABLE ${name} 

    (CUID BIGINT NOT NULL,

     
INTEREST BLOB(10k),

     primaryKey(CUID))

用于创建 Interest 表的 SQL 命令

imq.persist.jdbc.table.IMQMSG35

CREATE TABLE ${name} 

    (MID VARCHAR(100) NOT NULL,

     
DID VARCHAR(100),

     MSGSIZE BIGINT,

     
MSG BLOB(1m),

     primaryKey(MID))

用于创建消息表的 SQL 命令

MSG 列的默认最大长度为 1 兆字节 (1m)。如果您希望消息超出此长度，请对长度进行相应设置。如果已经创建了这些表，则必须重新创建它们才能更改最大消息长度。

imq.persist.jdbc.table.IMQPROPS35

CREATE TABLE ${name} 

    (PROPNAME VARCHAR(100) NOT NULL,

     
PROPVALUE BLOB(10k),

     primaryKey(PROPNAME))

用于创建属性表的 SQL 命令

imq.persist.jdbc.table.IMQILIST35

CREATE TABLE ${name} 

    (MID VARCHAR(100) NOT NULL,

     
CUID BIGINT,

     DID VARCHAR(100),

     
STATE INTEGER,

     primaryKey(MID, CUID))

用于创建 Interest 状态表的 SQL 命令

imq.persist.jdbc.table.IMQTXN35

CREATE TABLE ${name} 

    (TUID BIGINT NOT NULL,

     
STATE INTEGER,

     
TSTATEOBJ BLOB(10K),

     primaryKey(TUID))

用于创建事务表的 SQL 命令

imq.persist.jdbc.table.IMQTACK35

CREATE TABLE ${name} 

    (TUID BIGINT NOT NULL,

     
TXNACK BLOB(10k))

用于创建事务确认表的 SQL 命令

安全属性

表 14–7 中列出了与安全服务相关的代理属性。

表 14–7 代理安全属性

属性 

类型 

默认值 

描述 

imq.accesscontrol.enabled

布尔值 

true

是否使用访问控制？

如果为 true，系统将检查访问控制属性文件，以验证是否允许经过验证的用户使用连接服务或执行与特定目的地有关的特定操作。

imq.serviceName.accesscontrol.enabled

布尔值 

无 

是否为连接服务使用访问控制？ 

如果指定，则覆盖指定连接服务的 imq.accesscontrol.enabled。

如果为 true，系统将检查访问控制属性文件，以验证是否允许经过验证的用户使用指定的连接服务或执行与特定目的地有关的特定操作。

imq.accesscontrol.file.filename

字符串 

accesscontrol. properties

访问控制属性文件的名称 

文件名指定了相对于访问控制目录的路径（请参见附录 A， Message QueueTM 数据在特定平台上的位置）。

imq.serviceName .accesscontrol.file.filename

字符串 

无 

连接服务的访问控制属性文件的名称 

如果指定，则覆盖指定连接服务的 imq.accesscontrol.file.filename。

文件名指定了相对于访问控制目录的路径（请参见附录 A， Message QueueTM 数据在特定平台上的位置）。

imq.authentication.type

字符串 

digest

密码编码方法：

    basic：Base-64


    digest：MD5

imq.serviceName .authentication.type

字符串 

无 

连接服务的密码编码方法：

    basic：Base-64


    digest：MD5


如果指定，则覆盖指定连接服务的 imq.authentication.type。

imq.authentication.basic.user_repository

字符串 

file

base-64 验证的用户系统信息库类型： 

    file：基于文件


    ldap：LDAP

imq.authentication.client.response.timeout

整数 

180

等待客户端响应验证请求的时间间隔（以秒为单位） 

imq.passfile.enabled

布尔值 

false

是否从密码文件获取密码？ 

imq.passfile.dirpath

字符串 

请参见附录 A， Message QueueTM 数据在特定平台上的位置

包含密码文件的目录的路径 

imq.passfile.name

字符串 

passfile

密码文件的名称

imq.imqcmd.password

字符串 

无 

管理用户的密码。 

命令实用程序 (imqcmd) 在执行命令前使用此密码验证用户。

imq.user_repository.ldap.server

字符串 

无 

LDAP 服务器的主机名和端口号

该值的格式为： 

    hostName: port


其中 hostName 是运行 LDAP 服务器的主机的全限定 DNS 名称，而 port 是服务器使用的端口号。
     

要指定故障转移服务器列表，请使用下面的语法： 

    host1: port1


    ldap://host2 : port2


    ldap://host3 :port3


    …
     

列表中的条目用空格分隔。请注意，每个故障转移服务器地址均带有 ldap:// 前缀。即使您使用 SSL 并将属性 imq.user_repository.ldap.ssl.enabled 设置为 true，也请使用此格式。您无需在地址中指定 ldaps。

imq.user_repository.ldap.principal

字符串 

无 

用于绑定到 LDAP 用户系统信息库的标识名

如果 LDAP 服务器允许匿名搜索，则无需此密码。

imq.user_repository.ldap.password [应仅在密码文件中使用]

字符串 

无 

用于绑定到 LDAP 用户系统信息库的密码

如果 LDAP 服务器允许匿名搜索，则无需此密码。

imq.user_repository.ldap.propertyName

待定 

待定 

待定 

imq.user_repository.ldap.base

字符串 

无 

LDAP 用户条目的目录库

imq.user_repository.ldap.uidattr

字符串 

无 

LDAP 用户名的特定于提供者的属性标识符

imq.user_repository.ldap.usrfilter

字符串 

无 

（可选）用于 LDAP 用户搜索的 JNDI 过滤器

imq.user_repository.ldap.grpsearch

布尔值 

false

是否启用 LDAP 组搜索？

注 –

Message Queue 不支持嵌套组。

imq.user_repository.ldap.grpbase

字符串 

无 

LDAP 组条目的目录库

imq.user_repository.ldap.gidattr

字符串 

无 

LDAP 组名的特定于提供者的属性标识符

imq.user_repository.ldap.memattr

字符串 

无 

LDAP 组中用户名的特定于提供者的属性标识符

imq.user_repository.ldap.grpfilter

字符串 

无 

（可选）用于 LDAP 组搜索的 JNDI 过滤器

imq.user_repository.ldap.timeout

整数 

280

LDAP 搜索的时间限制（以秒为单位）

imq.user_repository.ldap.ssl.enabled

布尔值 

false

与 LDAP 服务器通信时是否使用 SSL？

imq.keystore.file.dirpath

字符串 

请参见附录 A， Message QueueTM 数据在特定平台上的位置

包含密钥库文件的目录的路径 

imq.keystore.file.name

字符串 

keystore

密钥库文件的名称 

imq.keystore.password

字符串 

无 

密钥库文件的密码 

imq.audit.enabled [仅适用于 Message Queue Enterprise Edition]

布尔值 

false

是否启动代理日志文件的审计日志？ 

监视属性

表 14–8 中列出了与监视服务相关的代理属性。

表 14–8 代理监视属性

属性 

类型 

默认值 

描述 

imq.log.level [可用于 imqcmd update bkr 命令]

字符串 

INFO

日志记录级别 

指定可以写入输出通道的日志记录信息的类别。可能的值为（由高至低）： 

    ERROR


    WARNING


    INFO


每个级别都包括高于它的级别（例如，WARNING 包括 ERROR）。

imq.destination.logDeadMsgs

布尔值 

false

是否记录有关停用消息的信息？ 

如果为 true，将记录以下事件：

  • 目的地已满，已达到最大大小或最大消息数。

  • 代理由于管理命令或传送确认以外的原因丢弃消息。

  • 代理将消息移动到停用消息队列。

imq.log.console.stream

字符串 

ERR

控制台输出的目的地： 

    OUT：stdout


    ERR：stderr


imq.log.console.output

字符串 

ERROR|WARNING

可写入控制台的日志记录信息的类别： 

    NONE


    ERROR


    WARNING


    INFO


    ALL


ERROR、WARNING 和 INFO 类别不包括高于它们的类别，因此必须根据需要明确指定每个类别。可以指定用竖线 (|) 分隔的任意类别组合。

imq.log.file.dirpath

字符串 

请参见附录 A， Message QueueTM 数据在特定平台上的位置

包含日志文件的目录的路径 

imq.log.file.filename

字符串 

log.txt

日志文件的名称 

imq.log.file.output

字符串 

ALL

可以写入日志文件的日志记录信息的类别： 

    NONE


    ERROR


    WARNING


    INFO


    ALL


ERROR、WARNING 和 INFO 类别不包括高于它们的类别，因此必须根据需要明确指定每个类别。可以指定用竖线 (|) 分隔的任意类别组合。

imq.log.file.rolloverbytes

整数 

-1

文件长度（以字节为单位），达到该值后，输出将转移到新的日志文件 

值为 -1 表示不限制字节数（不基于文件长度转移输出）。

imq.log.file.rolloversecs

整数 

604800（一周）

文件的存留期（以秒为单位），达到该值后，输出将转移到新的日志文件 

值为 -1 表示不限制秒数（不基于文件生存期转移输出）。

imq.log.syslog.output [仅限于 Solaris 平台]

字符串 

ERROR

可以写入 syslogd(1M) 的日志记录信息的类别：

    NONE


    ERROR


    WARNING


    INFO


    ALL


ERROR、WARNING 和 INFO 类别不包括高于它们的类别，因此必须根据需要明确指定每个类别。可以指定用竖线 (|) 分隔的任意类别组合。

imq.log.syslog.facility

字符串 

LOG_DAEMON

用于记录消息的 syslog 工具

可能的值镜像 syslog(3C) 手册页中所列出的值。适用于 Message Queue 的值包括：

    LOG_USER


    LOG_DAEMON


    LOG_LOCAL0


    LOG_LOCAL1


    LOG_LOCAL2


    LOG_LOCAL3


    LOG_LOCAL4


    LOG_LOCAL5


    LOG_LOCAL6


    LOG_LOCAL7


imq.log.syslog.identity

字符串 

imqbrokerd_${imq.instanceName }

标识字符串，该字符串将被加到记录到 syslog 中的每条消息的前面。

imq.log.syslog.logpid

布尔值 

true

是否将代理进程 ID 与消息一起记录？ 

imq.log.syslog.logconsole

布尔值 

false

如果无法将消息发送到 syslog，是否将其写入系统控制台？

imq.log.timezone

字符串 

当地时区 

日志时间戳的时区 

可能的值与方法 java.util.TimeZone.getTimeZone 使用的值相同。

示例：

    GMT


    GMT-8:00


    America/LosAngeles


    Europe/Rome


    Asia/Tokyo


imq.metrics.enabled

布尔值 

true

是否将度量信息写入记录程序？

不影响度量消息的生成（由 imq.metrics.topic.enabled 控制）。

imq.metrics.interval

整数 

-1

将度量信息写入记录程序的时间间隔（以秒为单位） 

不影响度量消息生成的时间间隔（由 imq.metrics.topic.interval 控制）。

值为 -1 表示时间间隔为无限长（永不将度量信息写入记录程序）。

imq.metrics.topic.enabled

布尔值 

true

是否向度量主题目的地生成度量消息？ 

如果为 false，则试图订阅度量主题目的地时会抛出客户端异常。

imq.metrics.topic.interval

整数 

60

向度量主题目的地中生成度量消息的时间间隔（以秒为单位） 

imq.metrics.topic.persist

布尔值 

false

发送到度量主题目的地的度量消息是否为永久性消息？ 

imq.metrics.topic.timetolive

整数 

300

发送到度量主题目的地的度量消息的生命周期（以秒为单位） 

群集配置属性

表 14–9 中列出了与代理群集相关的配置属性。

表 14–9 群集配置的代理属性

属性 

类型 

默认值 

描述 

imq.cluster.brokerlist [群集中的所有代理必须具有相同的值。]

字符串 

无 

代理地址的列表 

该列表中包含一个或多个用逗号分隔的地址。每个地址指定了群集中某个代理的主机名和端口映射器端口号，格式为 hostName: portNumber。

示例：

    host1:3000,host2:8000,ctrlhost


imq.cluster.hostname [可以为群集中的每个代理单独指定。]

字符串 

无 

cluster 连接服务的主机名或 IP 地址

如果指定，则覆盖 cluster 连接服务的 imq.hostname（请参见表 14–1）。

imq.cluster.port

整数 

0

cluster 连接服务的端口号

值为 0 表示应当由端口映射器动态分配端口号。

imq.cluster.transport

字符串 

tcp

cluster 连接服务的网络传输协议

要在代理之间实现安全、加密的消息传送，请将此属性设置为 ssl。

imq.cluster.url, [可用于 imqcmd update bkr 命令]

字符串 

无 

cluster 配置文件的 URL（如果有）

示例：

    http://webserver/imq/cluster.properties


    （对于 Web 服务器上的文件）


    file:/net/mfsserver/imq/cluster.properties


    （对于共享驱动器上的文件）

imq.cluster.masterbroker

字符串 

无 

群集主代理的主机名和端口号（如果有） 

该值的格式为 hostName: portNumber，其中 hostName 是主代理的主机名，portNumber 是它的端口映射器端口号。

示例：

    ctrlhost:7676


按字母顺序排列的代理属性列表

按字母顺序排列的代理属性列表是按字母顺序排列的代理配置属性列表，其中包含对本章中相关表的交叉引用。

表 14–10 按字母顺序排列的代理属性列表

属性 

表 

imq.accesscontrol.enabled

表 14–7

imq.accesscontrol.file.filename

表 14–7

imq.audit.enabled

表 14–7

imq.authentication.basic.user_repository

表 14–7

imq.authentication.client.response.timeout

表 14–7

imq.authentication.type

表 14–7

imq.autocreate.destination.isLocalOnly

表 14–3

imq.autocreate.destination.limitBehavior

表 14–3

imq.autocreate.destination.maxBytesPerMsg

表 14–3

imq.autocreate.destination.maxNumMsgs

表 14–3

imq.autocreate.destination.maxNumProducers

表 14–3

imq.autocreate.destination.maxTotalMsgBytes

表 14–3

imq.autocreate.destination.useDMQ

表 14–3

imq.autocreate.queue

表 14–3

imq.autocreate.queue.consumerFlowLimit

表 14–3

imq.autocreate.queue.localDeliveryPreferred

表 14–3

imq.autocreate.queue.maxNumActiveConsumers

表 14–3

imq.autocreate.queue.maxNumBackupConsumers

表 14–3

imq.autocreate.topic

表 14–3

imq.autocreate.topic.consumerFlowLimit

表 14–3

imq.cluster.brokerlist

表 14–9

imq.cluster.hostname

表 14–9

imq.cluster.masterbroker

表 14–9

imq.cluster.port

表 14–9

imq.cluster.transport

表 14–9

imq.cluster.url

表 14–9

imq.destination.DMQ.truncateBody

表 14–2

imq.destination.logDeadMsgs

表 14–8

imq.hostname

表 14–1

imq.imqcmd.password

表 14–7

imq.keystore.file.dirpath

表 14–7

imq.keystore.file.name

表 14–7

imq.keystore.password

表 14–7

imq.keystore.propertyName

表 14–7

imq.log.console.output

表 14–8

imq.log.console.stream

表 14–8

imq.log.file.dirpath

表 14–8

imq.log.file.filename

表 14–8

imq.log.file.output

表 14–8

imq.log.file.rolloverbytes

表 14–8

imq.log.file.rolloversecs

表 14–8

imq.log.level

表 14–8

imq.log.syslog.facility

表 14–8

imq.log.syslog.identity

表 14–8

imq.log.syslog.logconsole

表 14–8

imq.log.syslog.logpid

表 14–8

imq.log.syslog.output

表 14–8

imq.log.timezone

表 14–8

imq.message.expiration.interval

表 14–2

imq.message.max_size

表 14–2

imq.metrics.enabled

表 14–8

imq.metrics.interval

表 14–8

imq.metrics.topic.enabled

表 14–8

imq.metrics.topic.interval

表 14–8

imq.metrics.topic.persist

表 14–8

imq.metrics.topic.timetolive

表 14–8

imq.passfile.dirpath

表 14–7

imq.passfile.enabled

表 14–7

imq.passfile.name

表 14–7

imq.persist.file.destination.message.filepool.limit

表 14–5

imq.persist.file.message.cleanup

表 14–5

imq.persist.file.message.filepool.cleanratio

表 14–5

imq.persist.file.message.max_record_size

表 14–5

imq.persist.file.sync.enabled

表 14–5

imq.persist.jdbc.brokerid

表 14–6

imq.persist.jdbc.closedburl

表 14–6

imq.persist.jdbc.createdburl

表 14–6

imq.persist.jdbc.driver

表 14–6

imq.persist.jdbc.needpassword

表 14–6

imq.persist.jdbc.opendburl

表 14–6

imq.persist.jdbc.password

表 14–6

imq.persist.jdbc.table.IMQCCREC35

表 14–6

imq.persist.jdbc.table.IMQDEST35

表 14–6

imq.persist.jdbc.table.IMQILIST35

表 14–6

imq.persist.jdbc.table.IMQINT35

表 14–6

imq.persist.jdbc.table.IMQMSG35

表 14–6

imq.persist.jdbc.table.IMQPROPS35

表 14–6

imq.persist.jdbc.table.IMQSV35

表 14–6

imq.persist.jdbc.table.IMQTACK35

表 14–6

imq.persist.jdbc.table.IMQTXN35

表 14–6

imq.persist.jdbc.user

表 14–6

imq.persist.store

表 14–4

imq.ping.interval

表 14–1

imq.portmapper.backlog

表 14–1

imq.portmapper.hostname

表 14–1

imq.portmapper.port

表 14–1

imq.resourceState .count

表 14–2

imq.resourceState .threshold

表 14–2

imq.service.activelist

表 14–1

imq.serviceName .accesscontrol.enabled

表 14–7

imq.serviceName .accesscontrol.file.filename

表 14–7

imq.serviceName .authentication.type

表 14–7

imq.serviceName .max_threads

表 14–1

imq.serviceName .min_threads

表 14–1

imq.serviceName .protocolType.hostname

表 14–1

imq.serviceName .protocolType.port

表 14–1

imq.serviceName .threadpool_model

表 14–1

imq.shared.connectionMonitor_limit

表 14–1

imq.system.max_count

表 14–2

imq.system.max_size

表 14–2

imq.transaction.autorollback

表 14–2

imq.user_repository.ldap.base

表 14–7

imq.user_repository.ldap.gidattr

表 14–7

imq.user_repository.ldap.grpbase

表 14–7

imq.user_repository.ldap.grpfilter

表 14–7

imq.user_repository.ldap.grpsearch

表 14–7

imq.user_repository.ldap.memattr

表 14–7

imq.user_repository.ldap.password

表 14–7

imq.user_repository.ldap.principal

表 14–7

imq.user_repository.ldap.propertyName

表 14–7

imq.user_repository.ldap.server

表 14–7

imq.user_repository.ldap.ssl.enabled

表 14–7

imq.user_repository.ldap.timeout

表 14–7

imq.user_repository.ldap.uidattr

表 14–7

imq.user_repository.ldap.usrfilter

表 14–7