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 服務;請參閱附錄 CHTTP/HTTPS 支援 以取得更多有關配置 httpjms 與 httpsjms 服務的資訊]

字串 

無 

連線服務的主機名稱或 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 × 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 × 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 × 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))
    

可供建立偏好表格的 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 MB (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))
    

可供建立偏好狀態表格的 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

存取控制特性檔的名稱 

檔案名稱可指定與存取控制目錄相關的路徑 (請參閱附錄 AMessage QueueTM 資料的特定平台位置)。

imq.serviceName .accesscontrol.file.filename

字串 

無 

連線服務的存取控制特性檔名稱 

如果指定,會置換指定之連線服務的 imq.accesscontrol.file.filename。

檔案名稱可指定與存取控制目錄相關的路徑 (請參閱附錄 AMessage QueueTM 資料的特定平台位置)。

imq.authentication.type

字串 

digest

密碼編碼方法:

    basic:Base64


    digest:MD5


imq.serviceName .authentication.type

字串 

無 

連線服務的密碼編碼方法:

    basic:Base64


    digest:MD5


如果指定,會置換指定之連線服務的 imq.authentication.type。

imq.authentication.basic.user_repository

字串 

file

Base64 認證的使用者儲存庫類型: 

    file:檔案式


    ldap:LDAP


imq.authentication.client.response.timeout

整數 

180

等待用戶端回應認證請求的時間間隔 (以秒為單位) 

imq.passfile.enabled

布林值 

false

要從密碼檔案取得密碼? 

imq.passfile.dirpath

字串 

請參閱附錄 AMessage 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

要使用 SSL 與 LDAP 伺服器進行通訊?

imq.keystore.file.dirpath

字串 

請參閱附錄 AMessage 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

字串 

請參閱附錄 AMessage 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