BEA ホーム | 製品 | dev2dev | support | askBEA
 ドキュメントのダウンロード   サイト マップ 
検索

 Previous Next Contents Index  

 


[JMS 接続ファクトリ] --> [コンフィグレーション] --> [一般]

タスク 関連マニュアル 属性

概要

このタブでは、JMS 接続ファクトリの一般的なコンフィグレーション属性を定義します。JMS サーバの定義が済んだら、1 つまたは複数の接続ファクトリをコンフィグレーションして、定義済み属性を備えた接続を作成できます。

タスク

JMS 接続ファクトリの作成

JMS 接続ファクトリのクローンの作成

JMS 接続ファクトリの削除

JMS 接続ファクトリの割り当て

関連マニュアル

(インターネット接続が必要です)

『管理者ガイド』の「JMS の管理

『WebLogic JMS プログラマーズ ガイド』の「WebLogic JMS の基礎

『WebLogic JMS プログラマーズ ガイド』の「WebLogic JMS の管理

『WebLogic JMS プログラマーズ ガイド』の「WebLogic JMS アプリケーションの開発

属性

属性の表示名

説明

値の制約

[名前]

このコンフィグレーションの名前。WebLogic Server では、MBean を使用してコンフィグレーションを実装および保持する。

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

属性 : Name

コンフィグレーション可能 : はい

読み取り可能 : はい

書き込み可能 : はい

[JNDIName]

JMS 接続ファクトリの JNDI 名。

接続ファクトリに割り当てられ、JNDI ネームスペース内で接続ファクトリのルックアップに使用される名前。接続ファクトリ名は別途コンフィグレーションされる。

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

属性 : JNDIName

コンフィグレーション可能 : はい

読み取り可能 : はい

書き込み可能 : はい

[クライアント ID]

この接続ファクトリを使用する恒久サブスクライバのクライアント ID。

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

属性 : ClientId

コンフィグレーション可能 : はい

動的 : はい

読み取り可能 : はい

書き込み可能 : はい

[デフォルト優先順位]

接続ファクトリの defaultPriority 属性。

優先順位が明示的に定義されていない場合にメッセージに適用するデフォルトの優先順位。このファクトリで作成された接続で生成され、DefaultPriority が -1 のすべてのメッセージは、この値を受け取る。

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

属性 : DefaultPriority

最小値 : PRIORITY_MINIMUM

最大値 : PRIORITY_MAXIMUM

デフォルト値 : PRIORITY_DEFAULT

コンフィグレーション可能 : はい

動的 : はい

読み取り可能 : はい

書き込み可能 : はい

[デフォルト生存時間]

接続ファクトリの DefaultTimeToLive 属性の値。

メッセージのデフォルトの最長存在期間(ミリ秒単位)。優先順位が明示的に定義されていない場合にメッセージに適用される。値 0 はメッセージが無限に存在することを示す。このファクトリで作成された接続で生成され、DefaultTimeToLive が -1 のすべてのメッセージは、ミリ秒で表されたこの値を受け取る。

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

属性 : DefaultTimeToLive

最小値 : 0

最大値 : 9223372036854775807

デフォルト値 : 0

コンフィグレーション可能 : はい

動的 : はい

読み取り可能 : はい

書き込み可能 : はい

[デフォルト配信時間]

接続ファクトリの DefaultTimeToDeliver 属性の値。

メッセージが生成されてから送り先で表示できるようになるまでのデフォルトの遅延時間(ミリ秒単位)を定義する。このファクトリで作成されたプロデューサによって生成され、DefaultTimeToDeliver が -1 のすべてのメッセージは、この値を使用する。

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

属性 : DefaultTimeToDeliver

最小値 : 0

最大値 : 9223372036854775807

デフォルト値 : 0

コンフィグレーション可能 : はい

動的 : はい

読み取り可能 : はい

書き込み可能 : はい

[デフォルト配信モード]

接続ファクトリの DefaultDeliveryMode 属性の値。

配信モードが明示的に定義されていない場合にメッセージに適用するデフォルトの配信モード。このファクトリで作成された接続で生成され、DefaultDeliveryMode が null のすべてのメッセージは、この値を受け取る。

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

属性 : DefaultDeliveryMode

デフォルト値 : PERSISTENT

有効な値 :

  • PERSISTENT

  • NON_PERSISTENT

コンフィグレーション可能 : はい

動的 : はい

読み取り可能 : はい

書き込み可能 : はい

[デフォルト再送遅延]

接続ファクトリの defaultRedeliveryDelay 属性の値。

ロールバックまたは回復されたメッセージが再配信されるまでのデフォルトの遅延時間(ミリ秒単位)を定義する。このファクトリで作成されたコンシューマによって消費され、DefaultRedeliveryDelay が -1 のすべてのメッセージは、この値を使用する。

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

属性 : DefaultRedeliveryDelay

最小値 : 0

最大値 : 9223372036854775807

デフォルト値 : 0

コンフィグレーション可能 : はい

動的 : はい

読み取り可能 : はい

書き込み可能 : はい

[最大メッセージ]

接続ファクトリの MessagesMaximum 属性の値。

非同期セッション向けに存在し、メッセージ リスナに渡されていないメッセージの最大数。値 -1 はメッセージ数を制限しないことを示す。ただし、その場合、使用可能な仮想メモリ量が制限される。メッセージ数が [最大メッセージ] の値に達した場合の処理は次のとおり。

  • マルチキャスト セッションの場合、新しいメッセージは [超過時のポリシー] 属性によって指定されたポリシーに従って破棄され、DataOverrunException が発生する。

  • 非マルチキャスト セッションの場合、新しいメッセージはフロー制御されるか、アプリケーションがメッセージを受け入れることができるまでサーバ上に保持される。

マルチキャスト セッションの場合、接続が停止してもメッセージの配信は、[最大メッセージ] 値に達するまで続行される。この値に達すると、メッセージは超過時のポリシーに従って破棄される。

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

属性 : MessagesMaximum

最小値 : -1

最大値 : 2147483647

デフォルト値 : 10

コンフィグレーション可能 : はい

動的 : はい

読み取り可能 : はい

書き込み可能 : はい

[超過時のポリシー]

接続ファクトリの OverrunPolicy 属性の値。

超過時のポリシーは、マルチキャスト メッセージに適用される。未処理のメッセージ数が [最大メッセージ] 属性値に達すると、メッセージは指定されたポリシーに従って破棄される。

  • [新しいメッセージを保持] に設定した場合、最新のメッセージが最も古いメッセージに対して優先され、必要に応じて、古いメッセージは破棄される。

  • [古いメッセージを保持] に設定した場合、最も古いメッセージが最新のメッセージに対して優先され、必要に応じて、最新のメッセージは破棄される。

メッセージの存在期間は受け取り順序によって決まり、JMSTimestamp 値によって定義されるわけではない。

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

属性 : OverrunPolicy

デフォルト値 : [古いメッセージを保持]

有効な値 :

  • [古いメッセージを保持]

  • [新しいメッセージを保持]

コンフィグレーション可能 : はい

動的 : はい

読み取り可能 : はい

書き込み可能 : はい

[メッセージの短縮を許可]

接続ファクトリの AllowCloseInOnMessage 属性の値。

close() メソッドを onMessage() メソッド呼び出し内で発行できるようにするメッセージ コンシューマを、接続ファクトリが作成するかどうかを指定する。

  • このフラグを有効(true)にした場合、永続的なブロッキングではなく、onMessage() メソッド呼び出し内からの close() メソッド呼び出しが成功する。セッションの通知モードを AUTO_ACKNOWLEDGE に設定した場合、onMessage() が完了しても現在のメッセージは自動的に通知される。

  • このフラグを選択しない場合(false)、onMessage() から呼び出されたときに stop() および close() メソッドがハングする。

この属性は動的であり、いつでも変更できる。ただし、この値を変更しても、既存の接続には効果が及ばない。その効果は、この接続ファクトリで作成された新しい接続だけに及ぶ。

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

属性 : AllowCloseInOnMessage

デフォルト値 : false

コンフィグレーション可能 : はい

動的 : はい

読み取り可能 : はい

書き込み可能 : はい

[確認応答ポリシー]

接続ファクトリの AcknowledgePolicy 属性の値。

注意 : この属性は、非トランザクション セッション用に CLIENT_ACKNOWLEDGE 確認応答モードを使用する実装にのみ適用される。

この属性は、JMS 仕様の変更の問題を回避する。具体的に説明すると、この仕様では確認応答されるメッセージとその前のすべてのメッセージを確認応答できた。しかし、以下に示すとおり、仕様の変更によって、任意のメッセージを確認応答すると受信済みのすべてのメッセージが確認応答されるようになった(確認応答されるメッセージの後に受信したメッセージも含む)。

  • ACKNOWLEDGE_PREVIOUS では、古い振る舞いが保持される(確認応答されるメッセージとその前のすべてのメッセージが確認応答される)。

  • ACKNOWLEDGE_ALL では、どのメッセージによって確認応答が発生したのかに関係なく、特定のセッションによって受信したすべてのメッセージが確認応答される。

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

属性 : AcknowledgePolicy

デフォルト値 : [All]

有効な値 :

  • [All]

  • [Previous]

コンフィグレーション可能 : はい

動的 : はい

読み取り可能 : はい

書き込み可能 : はい

[ロード バランスを有効化]

接続ファクトリの LoadBalancingEnabled 属性の値。

接続ファクトリを使用して作成した匿名でないプロデューサが、呼び出しごとに分散送り先へのロード バランシングの対象となるかどうかを指定する。

  • true の場合、関連付けられたメッセージ プロデューサのすべての send() または publish() でロード バランシングが実行される。

  • false の場合、関連付けられたメッセージ プロデューサの最初の send() または publish() でロード バランシングが実行される。

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

属性 : LoadBalancingEnabled

デフォルト値 : true

動的 : はい

読み取り可能 : はい

書き込み可能 : はい

[サーバ アフィニティを有効化]

接続ファクトリの ServerAffinityEnabled 属性の値。

WebLogic Server で、分散送り先セット内の複数の物理送り先にまたがってコンシューマまたはプロデューサのロード バランシングを実行するときに、同じサーバ内で動作する物理送り先のロード バランシングを最初に試行するかどうかを指定する。

MBean: weblogic.management.
configuration.
JMSConnectionFactoryMBean

属性 : ServerAffinityEnabled

デフォルト値 : true

読み取り可能 : はい

書き込み可能 : はい



 

Back to Top Previous Next