Interstage Application Server/Interstage Web Server Java EE運用ガイド

6.7.3 物理格納先自動生成に関するプロパティ

本プロパティは、物理格納先の自動作成時に物理格納先の設定値として反映されます。
すでに自動生成されている物理格納先の設定を変更する場合は、imqcmd update dstコマンドに「物理格納先の生成または更新に関するプロパティ」を指定して更新してください。

プロパティ	構成情報	設定値	省略値	コマンドでの設定 (値の範囲)
				imqbrokerd	imqcmd
imq.autocreate.destination.maxBytesPerMsg	物理格納先で許容される単一のメッセージの最大サイズ(単位:バイト／キロバイト／メガバイト(注1))を指定します。本プロパティは、limitBehaviorプロパティをREJECT_NEWESTに設定した場合にだけ有効となります。 メッセージが指定値を超える場合、プロデューサに例外通知されます(持続性のないメッセージの場合は通知されません)。 「-1」を指定した場合、許容される単一のメッセージの最大サイズは無制限となります。	整数値	10m	○ (-1, 1～2147483647)	×
imq.autocreate.destination.maxTotalMsgBytes	物理格納先に許容されるメッセージの最大合計サイズ(単位:バイト／キロバイト／メガバイト(注1))を指定します。 「-1」を指定した場合、許容されるメッセージの最大合計サイズは無制限となります。	整数値	10240m	○ (-1, 1～2147483647)	×
imq.autocreate.destination.limitBehavior	maxTotalMsgBytes／maxBytesPerMsg／maxNumMsgsの制限値に達した場合のメッセージブローカの応答方法を指定します。 以下のいずれかを選択します。 FLOW_CONTROL メッセージが物理格納先に蓄積可能になるまでメッセージの蓄積処理を待機させます。(注2) REMOVE_OLDEST 最も古いメッセージを破棄します。 REMOVE_LOW_PRIORITY 有効期限に従って最も優先度の低いメッセージを破棄します。プロデューサには通知しません。 REJECT_NEWEST 新しいメッセージを拒否します。持続メッセージの場合にだけ、プロデューサに例外を通知します。	FLOW_CONTROL REMOVE_OLDEST REMOVE_LOW_PRIORITY REJECT_NEWEST	REJECT_NEWEST	○	×
imq.autocreate.destination.maxNumMsgs	物理格納先で許容される蓄積メッセージ数の最大数を指定します。 「-1」を指定した場合、許容される蓄積メッセージ数の最大数は無制限となります。	整数値	100000	○ (-1, 1～2147483647)	×
imq.autocreate.destination.maxNumProducers	物理格納先に接続できるプロデューサの最大数を指定します。 「-1」を指定した場合、接続できるプロデューサの最大数は無制限となります。	整数値	100	○ (-1, 1～2147483647)	×
imq.autocreate.destination.useDMQ	物理格納先が制限値などによりメッセージを破棄する場合に、デッドメッセージキューに退避するか、メッセージを破棄するかを指定します。 falseの場合は、メッセージを破棄します。	true false	true	○	×
imq.autocreate.queue	Queueの自動作成を許可するかを指定します。 falseの場合は、Queueの自動作成を許可しません。	true false	true	○	○
imq.autocreate.queue.consumerFlowLimit	Queueに対してだけ有効な設定です。 メッセージブローカに接続した時点で、メッセージコンシューマに配信可能なメッセージの数を指定します。 「-1」を指定した場合、メッセージコンシューマに配信可能なメッセージの数は無制限となります。 メッセージの有効期限を設定して運用を行う場合は、本値に小さい値を設定することを推奨します。	整数値	1000	○ (-1, 1～2147483647)	×
imq.autocreate.queue.maxNumActiveConsumers	Queueに対してだけ有効な設定です。 物理格納先からメッセージを受信できるコンシューマの最大数を指定します。 「-1」を指定した場合、物理格納先からメッセージを受信できるコンシューマの最大数は無制限となります。	整数値	-1	○ (-1, 1～2147483647)	○ (-1, 1～2147483647)
imq.autocreate.queue.maxNumBackupConsumers	Queueに対してだけ有効な設定です。 物理格納先からメッセージを受信待機できるコンシューマの最大数を指定します。 「-1」を指定した場合、物理格納先からメッセージを受信待機できるコンシューマの最大数は無制限となります。	整数値	0	○ (-1～2147483647)	○ (-1～2147483647)
imq.autocreate.topic	Topicの自動作成を許可するかどうかを指定します。 falseの場合は、Topicの自動作成を許可しません。	true false	true	○	○
imq.autocreate.topic.consumerFlowLimit	Topicに対してだけ有効な設定です。 メッセージブローカに接続した時点で、メッセージコンシューマに配信可能なメッセージの数を指定します。 「-1」を指定した場合、メッセージコンシューマに配信可能なメッセージの数は無制限となります。 メッセージの有効期限を設定して運用を行う場合には、本値に小さい値を設定することを推奨します。	整数値	1000	○ (-1, 1～2147483647)	×

○:設定可能    ×:設定不可

注1)

単位は、数値の後ろに、以下の半角英字を付加して指定します(省略時:バイト)。

• 単位がバイトの場合：b
  例）100b

• 単位がキロバイト（1024バイト）の場合：k
  例）100k

• 単位がメガバイト（1024×1024バイト）場合：m
  例）100m

注2)

待機状態が解除されるまで、プロデューサに処理は復帰しません。