EJB コンテナー (ejbContainer)
EJB コンテナーの動作を定義します。
| 属性名 | データ型 | デフォルト値 | 説明 |
|---|---|---|---|
| cacheCleanupInterval | 期間 (精度: 秒) | 3s | サイズ超過時に、未使用のステートフル・セッション Bean インスタンス のパッシベーションを実行する間隔。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、または秒 (s) が可能です。例えば、30 秒は 30s と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1m30s は 90 秒に相当します。 |
| cacheSize | int 最小: 1 |
2053 | メモリーにキャッシュする必要のあるステートフル・セッション Bean インスタンスの数。 |
| poolCleanupInterval | 期間 (精度: 秒) | 30s | 未使用 Bean インスタンスを削除する間隔。 この設定は、ステートレス・セッション Bean およびメッセージ駆動型 Bean にのみ 適用されます。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、または秒 (s) が可能です。例えば、30 秒は 30s と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1m30s は 90 秒に相当します。 |
| startEJBsAtAppStart | boolean | EJB タイプがいつ初期化されるかを指定します。このプロパティーが true に設定されると、EJB タイプはアプリケーションが最初に開始する時点で初期化されます。このプロパティーが false に設定されると、EJB タイプはアプリケーションによって最初に使用される時点で初期化されます。このプロパティーが設定されていない場合には、この振る舞いは ibm-ejb-jar-ext.xml ファイル内の start-at-app-start 属性から、Bean ごとに決定されます。この設定は、メッセージ駆動型 Bean や開始 singleton Bean には適用されません。メッセージ駆動型 Bean や開始 singleton Bean は、アプリケーションの開始時に必ず初期化されます。 |
- asynchronous
説明: EJB 非同期メソッドの振る舞いを定義します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 contextServiceRef 最上位の contextService エレメント (ストリング) の参照。 非同期 EJB メソッド・スレッドへのコンテキスト伝搬の管理に使用されるコンテキスト・サービス。 maxUnclaimedRemoteResults int 最小: 1
1000 Future オブジェクトを返すすべてのリモート非同期メソッド呼び出しからサーバーが保存する、要求されない結果の最大数。この最大数を超えると、メモリー・リークを防止するため、サーバーは一番早くに完了したメソッド呼び出しの結果を消去します。 unclaimedRemoteResultTimeout 期間 (精度: 秒) 24h Future オブジェクトを返す各リモート非同期メソッド呼び出しの結果をサーバーが保持する期間。指定された期間内にアプリケーションが結果を要求しない場合、メモリー・リークを防止するために、サーバーはそのメソッド呼び出しの結果を消去します。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、または秒 (s) が可能です。例えば、30 秒は 30s と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1m30s は 90 秒に相当します。 - asynchronous > contextService
説明: 非同期 EJB メソッド・スレッドへのコンテキスト伝搬の管理に使用されるコンテキスト・サービス。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 baseContextRef 最上位の contextService エレメント (ストリング) の参照。 このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。 jndiName string JNDI 名 onError - IGNORE
- FAIL
- WARN
WARN 構成エラーに対応して実行されるアクションを 決定します。例えば、この contextService に securityContext が 構成されているが、セキュリティー・フィーチャーが有効になっていない 場合に、失敗にするのか、警告を発行するのか、それとも構成の不正部分を無視する のかを onError が決定します。 - IGNORE
- サーバーは、構成エラーが発生したときに、警告メッセージもエラー・メッセージも出しません。
- FAIL
- サーバーは、最初のエラー発生時に警告メッセージまたはエラー・メッセージを出してから、サーバーを停止します。
- WARN
- サーバーは、構成エラーが発生すると警告メッセージおよびエラー・メッセージを出します。
- asynchronous > contextService > baseContext
説明: このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 baseContextRef 最上位の contextService エレメント (ストリング) の参照。 このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。 id string 固有の構成 ID。 jndiName string JNDI 名 onError - IGNORE
- FAIL
- WARN
WARN 構成エラーに対応して実行されるアクションを 決定します。例えば、この contextService に securityContext が 構成されているが、セキュリティー・フィーチャーが有効になっていない 場合に、失敗にするのか、警告を発行するのか、それとも構成の不正部分を無視する のかを onError が決定します。 - IGNORE
- サーバーは、構成エラーが発生したときに、警告メッセージもエラー・メッセージも出しません。
- FAIL
- サーバーは、最初のエラー発生時に警告メッセージまたはエラー・メッセージを出してから、サーバーを停止します。
- WARN
- サーバーは、構成エラーが発生すると警告メッセージおよびエラー・メッセージを出します。
- asynchronous > contextService > baseContext > baseContext
説明: このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。必須: falseデータ型: com.ibm.ws.context.service-factory
- asynchronous > contextService > baseContext > classloaderContext
説明: クラス・ローダー・コンテキスト伝搬構成。必須: falseデータ型:
- asynchronous > contextService > baseContext > jeeMetadataContext
説明: タスクで使用可能なコンテキスト・タスクをサブミットするアプリケーション・コンポーネントの名前空間を作成します。必須: falseデータ型:
- asynchronous > contextService > baseContext > securityContext
説明: これが指定されると、作業イニシエーターのセキュリティー・コンテキストが作業単位に伝搬されます。必須: falseデータ型:
- asynchronous > contextService > baseContext > syncToOSThreadContext
説明: これが指定されると、作業単位の runAs サブジェクトの ID が オペレーティング・システム ID と同期されます。必須: falseデータ型:
- asynchronous > contextService > baseContext > zosWLMContext
説明: z/OS WLM コンテキストがスレッド・コンテキストの一部として管理されることを示します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 daemonTransactionClass string ASYNCDMN デーモン作業用に新しい WLM コンテキストが作成されるときに、作業を分類するために WLM に提供されるトランザクション・クラス名。 defaultTransactionClass string ASYNCBN 非デーモン作業用に新しい WLM コンテキストが作成されるときに、作業を分類するために WLM に提供されるトランザクション・クラス名。 wlm - Propagate
- PropagateOrNew
- New
Propagate 非デーモン作業で WLM コンテキストをどのように扱うかを示します。 - Propagate
- 同じ WLM コンテキストを使用 (存在する場合)。
- PropagateOrNew
- 同じ WLM コンテキストを使用するか、または新しい WLM コンテキストを作成 (現行コンテキストが存在しない場合) します。
- New
- 常に、新しい WLM コンテキストを作成します。
- asynchronous > contextService > jeeMetadataContext
説明: タスクで使用可能なコンテキスト・タスクをサブミットするアプリケーション・コンポーネントの名前空間を作成します。必須: falseデータ型:
- asynchronous > contextService > securityContext
説明: これが指定されると、作業イニシエーターのセキュリティー・コンテキストが作業単位に伝搬されます。必須: falseデータ型:
- asynchronous > contextService > syncToOSThreadContext
説明: これが指定されると、作業単位の runAs サブジェクトの ID が オペレーティング・システム ID と同期されます。必須: falseデータ型:
- asynchronous > contextService > zosWLMContext
説明: z/OS WLM コンテキストがスレッド・コンテキストの一部として管理されることを示します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 daemonTransactionClass string ASYNCDMN デーモン作業用に新しい WLM コンテキストが作成されるときに、作業を分類するために WLM に提供されるトランザクション・クラス名。 defaultTransactionClass string ASYNCBN 非デーモン作業用に新しい WLM コンテキストが作成されるときに、作業を分類するために WLM に提供されるトランザクション・クラス名。 wlm - Propagate
- PropagateOrNew
- New
Propagate 非デーモン作業で WLM コンテキストをどのように扱うかを示します。 - Propagate
- 同じ WLM コンテキストを使用 (存在する場合)。
- PropagateOrNew
- 同じ WLM コンテキストを使用するか、または新しい WLM コンテキストを作成 (現行コンテキストが存在しない場合) します。
- New
- 常に、新しい WLM コンテキストを作成します。
- timerService
説明: EJB タイマー・サービスの動作を定義します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 lateTimerThreshold 期間 (精度: 分) 5m タイマーの開始が遅延していると見なされるまでの、スケジュールされたタイマー有効期限切れ以降の分数。タイマーの開始が遅延した場合、タイマーがスケジュールより遅く開始したことを示す警告メッセージがログに記録されます。デフォルトのしきい値は 5 分であり、値 0 は警告メッセージ機能をオフにすることを意味します。正整数の後に時間単位 (時間 (h)、または分 (m)) を付けて指定してください。 例えば、30 分は 30m と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1h30m は 90 分に相当します。 nonPersistentMaxRetries int 最小: -1
-1 非パーシスタント・タイマーの有効期限が切れると、タイムアウト・コールバック・メソッドが呼び出されます。この設定により、EJB コンテナーがタイマーを再試行する回数が制御されます。このコールバック・メソッドのトランザクションが失敗したか、ロールバックされた場合、EJB コンテナーは、少なくとも 1 回タイマーを再試行する必要があります。デフォルト値は -1 で、これは EJB コンテナーがタイマーが成功するまで無限に再試行することを意味します。値が 0 に設定された場合、EJB コンテナーはタイマーを再試行しませんが、その結果として EJB 仕様に準拠しない動作になります。 nonPersistentRetryInterval 期間 (精度: 秒) 300s 非パーシスタント・タイマーの有効期限が切れると、タイムアウト・コールバック・メソッドが呼び出されます。このコールバック・メソッドのトランザクションが失敗するかロールバックされた場合、コンテナーはタイマーを再試行する必要があります。最初の再試行は直ちに実行され、後続の再試行は指定した秒数だけ遅延します。値が 0 に設定された場合は、すべての再試行が直ちに実行されます。値を指定しない場合、デフォルトの時間間隔は 300 秒です。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、または秒 (s) が可能です。例えば、30 秒は 30s と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1m30s は 90 秒に相当します。 persistentExecutorRef 最上位の persistentExecutor エレメント (ストリング) の参照。 EJB パーシスタント・タイマーのタスクをスケジュールし、実行します。 - timerService > persistentExecutor
説明: EJB パーシスタント・タイマーのタスクをスケジュールし、実行します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 contextServiceRef 最上位の contextService エレメント (ストリング) の参照。 DefaultContextService コンテキストがスレッドに取り込まれる方法および伝搬される方法を構成します。 enableTaskExecution boolean true このインスタンスがタスクを実行できるかどうかを決定します。 initialPollDelay 期間 (精度: ミリ秒) 0 このインスタンスがパーシスタント・ストアに対し、実行するタスクについてポーリングするまでの待機時間。値 -1 は、プログラムで開始されるまでポーリングを遅らせます。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、秒 (s)、またはミリ秒 (ms) が可能です。例えば、500 ミリ秒は 500ms と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1s500ms は 1.5 秒に相当します。 pollInterval 期間 (精度: ミリ秒) -1 実行するタスクについてポーリングする間隔。値 -1 を指定すると、初期ポーリング後のすべてのポーリングが無効になります。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、秒 (s)、またはミリ秒 (ms) が可能です。例えば、500 ミリ秒は 500ms と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1s500ms は 1.5 秒に相当します。 pollSize int 最小: 1
実行するタスクについてパーシスタント・ストアをポーリングするときに検出するタスク・エントリーの最大数。指定されていない場合、制限はありません。 retryInterval 期間 (精度: ミリ秒) 1m 失敗したタスクの 2 番目以降の連続再試行間に経過する必要のある時間。最初の再試行は、この属性の値に関わらず即時実行されます。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、秒 (s)、またはミリ秒 (ms) が可能です。例えば、500 ミリ秒は 500ms と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1s500ms は 1.5 秒に相当します。 retryLimit short 最小: -1
最大: 10000
10 失敗またはロールバックしたタスクの連続再試行回数の制限。この制限を超えたタスクは、永続的失敗と見なされ、それ以上の再試行は行われません。値 -1 は無制限の再試行を許可します。 taskStoreRef 最上位の databaseStore エレメント (ストリング) の参照。 defaultDatabaseStore スケジュールされたタスク用のパーシスタント・ストア。 - timerService > persistentExecutor > contextService
説明: コンテキストがスレッドに取り込まれる方法および伝搬される方法を構成します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 baseContextRef 最上位の contextService エレメント (ストリング) の参照。 このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。 jndiName string JNDI 名 onError - IGNORE
- FAIL
- WARN
WARN 構成エラーに対応して実行されるアクションを 決定します。例えば、この contextService に securityContext が 構成されているが、セキュリティー・フィーチャーが有効になっていない 場合に、失敗にするのか、警告を発行するのか、それとも構成の不正部分を無視する のかを onError が決定します。 - IGNORE
- サーバーは、構成エラーが発生したときに、警告メッセージもエラー・メッセージも出しません。
- FAIL
- サーバーは、最初のエラー発生時に警告メッセージまたはエラー・メッセージを出してから、サーバーを停止します。
- WARN
- サーバーは、構成エラーが発生すると警告メッセージおよびエラー・メッセージを出します。
- timerService > persistentExecutor > contextService > baseContext
説明: このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 baseContextRef 最上位の contextService エレメント (ストリング) の参照。 このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。 id string 固有の構成 ID。 jndiName string JNDI 名 onError - IGNORE
- FAIL
- WARN
WARN 構成エラーに対応して実行されるアクションを 決定します。例えば、この contextService に securityContext が 構成されているが、セキュリティー・フィーチャーが有効になっていない 場合に、失敗にするのか、警告を発行するのか、それとも構成の不正部分を無視する のかを onError が決定します。 - IGNORE
- サーバーは、構成エラーが発生したときに、警告メッセージもエラー・メッセージも出しません。
- FAIL
- サーバーは、最初のエラー発生時に警告メッセージまたはエラー・メッセージを出してから、サーバーを停止します。
- WARN
- サーバーは、構成エラーが発生すると警告メッセージおよびエラー・メッセージを出します。
- timerService > persistentExecutor > contextService > baseContext > baseContext
説明: このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。必須: falseデータ型: com.ibm.ws.context.service-factory
- timerService > persistentExecutor > contextService > baseContext > classloaderContext
説明: クラス・ローダー・コンテキスト伝搬構成。必須: falseデータ型:
- timerService > persistentExecutor > contextService > baseContext > jeeMetadataContext
説明: タスクで使用可能なコンテキスト・タスクをサブミットするアプリケーション・コンポーネントの名前空間を作成します。必須: falseデータ型:
- timerService > persistentExecutor > contextService > baseContext > securityContext
説明: これが指定されると、作業イニシエーターのセキュリティー・コンテキストが作業単位に伝搬されます。必須: falseデータ型:
- timerService > persistentExecutor > contextService > baseContext > syncToOSThreadContext
説明: これが指定されると、作業単位の runAs サブジェクトの ID が オペレーティング・システム ID と同期されます。必須: falseデータ型:
- timerService > persistentExecutor > contextService > baseContext > zosWLMContext
説明: z/OS WLM コンテキストがスレッド・コンテキストの一部として管理されることを示します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 daemonTransactionClass string ASYNCDMN デーモン作業用に新しい WLM コンテキストが作成されるときに、作業を分類するために WLM に提供されるトランザクション・クラス名。 defaultTransactionClass string ASYNCBN 非デーモン作業用に新しい WLM コンテキストが作成されるときに、作業を分類するために WLM に提供されるトランザクション・クラス名。 wlm - Propagate
- PropagateOrNew
- New
Propagate 非デーモン作業で WLM コンテキストをどのように扱うかを示します。 - Propagate
- 同じ WLM コンテキストを使用 (存在する場合)。
- PropagateOrNew
- 同じ WLM コンテキストを使用するか、または新しい WLM コンテキストを作成 (現行コンテキストが存在しない場合) します。
- New
- 常に、新しい WLM コンテキストを作成します。
- timerService > persistentExecutor > contextService > classloaderContext
説明: クラス・ローダー・コンテキスト伝搬構成。必須: falseデータ型:
- timerService > persistentExecutor > contextService > jeeMetadataContext
説明: タスクで使用可能なコンテキスト・タスクをサブミットするアプリケーション・コンポーネントの名前空間を作成します。必須: falseデータ型:
- timerService > persistentExecutor > contextService > securityContext
説明: これが指定されると、作業イニシエーターのセキュリティー・コンテキストが作業単位に伝搬されます。必須: falseデータ型:
- timerService > persistentExecutor > contextService > syncToOSThreadContext
説明: これが指定されると、作業単位の runAs サブジェクトの ID が オペレーティング・システム ID と同期されます。必須: falseデータ型:
- timerService > persistentExecutor > contextService > zosWLMContext
説明: z/OS WLM コンテキストがスレッド・コンテキストの一部として管理されることを示します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 daemonTransactionClass string ASYNCDMN デーモン作業用に新しい WLM コンテキストが作成されるときに、作業を分類するために WLM に提供されるトランザクション・クラス名。 defaultTransactionClass string ASYNCBN 非デーモン作業用に新しい WLM コンテキストが作成されるときに、作業を分類するために WLM に提供されるトランザクション・クラス名。 wlm - Propagate
- PropagateOrNew
- New
Propagate 非デーモン作業で WLM コンテキストをどのように扱うかを示します。 - Propagate
- 同じ WLM コンテキストを使用 (存在する場合)。
- PropagateOrNew
- 同じ WLM コンテキストを使用するか、または新しい WLM コンテキストを作成 (現行コンテキストが存在しない場合) します。
- New
- 常に、新しい WLM コンテキストを作成します。
参照トピック