Persistent Scheduled Executor (persistentExecutor)
パーシスタント・タスクをスケジュールし、実行します。
| 属性名 | データ型 | デフォルト値 | 説明 |
|---|---|---|---|
| contextServiceRef | 最上位の contextService エレメント (ストリング) の参照。 | DefaultContextService | コンテキストがスレッドに取り込まれる方法および伝搬される方法を構成します。 |
| enableTaskExecution | boolean | true | このインスタンスがタスクを実行できるかどうかを決定します。 |
| id | string | 固有の構成 ID。 | |
| 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 | スケジュールされたタスク用のパーシスタント・ストア。 |
- contextService
説明: コンテキストがスレッドに取り込まれる方法および伝搬される方法を構成します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 baseContextRef 最上位の contextService エレメント (ストリング) の参照。 このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。 jndiName string JNDI 名 onError - IGNORE
- FAIL
- WARN
WARN 構成エラーに対応して実行されるアクションを 決定します。例えば、この contextService に securityContext が 構成されているが、セキュリティー・フィーチャーが有効になっていない 場合に、失敗にするのか、警告を発行するのか、それとも構成の不正部分を無視する のかを onError が決定します。 - IGNORE
- サーバーは、構成エラーが発生したときに、警告メッセージもエラー・メッセージも出しません。
- FAIL
- サーバーは、最初のエラー発生時に警告メッセージまたはエラー・メッセージを出してから、サーバーを停止します。
- WARN
- サーバーは、構成エラーが発生すると警告メッセージおよびエラー・メッセージを出します。
- contextService > baseContext
説明: このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 baseContextRef 最上位の contextService エレメント (ストリング) の参照。 このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。 id string 固有の構成 ID。 jndiName string JNDI 名 onError - IGNORE
- FAIL
- WARN
WARN 構成エラーに対応して実行されるアクションを 決定します。例えば、この contextService に securityContext が 構成されているが、セキュリティー・フィーチャーが有効になっていない 場合に、失敗にするのか、警告を発行するのか、それとも構成の不正部分を無視する のかを onError が決定します。 - IGNORE
- サーバーは、構成エラーが発生したときに、警告メッセージもエラー・メッセージも出しません。
- FAIL
- サーバーは、最初のエラー発生時に警告メッセージまたはエラー・メッセージを出してから、サーバーを停止します。
- WARN
- サーバーは、構成エラーが発生すると警告メッセージおよびエラー・メッセージを出します。
- contextService > baseContext > baseContext
説明: このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。必須: falseデータ型: com.ibm.ws.context.service-factory
- contextService > baseContext > jeeMetadataContext
説明: タスクで使用可能なコンテキスト・タスクをサブミットするアプリケーション・コンポーネントの名前空間を作成します。必須: falseデータ型:
- contextService > baseContext > securityContext
説明: これが指定されると、作業イニシエーターのセキュリティー・コンテキストが作業単位に伝搬されます。必須: falseデータ型:
- contextService > baseContext > syncToOSThreadContext
説明: これが指定されると、作業単位の runAs サブジェクトの ID が オペレーティング・システム ID と同期されます。必須: falseデータ型:
- 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 コンテキストを作成します。
- contextService > jeeMetadataContext
説明: タスクで使用可能なコンテキスト・タスクをサブミットするアプリケーション・コンポーネントの名前空間を作成します。必須: falseデータ型:
- contextService > syncToOSThreadContext
説明: これが指定されると、作業単位の runAs サブジェクトの ID が オペレーティング・システム ID と同期されます。必須: falseデータ型:
- 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 コンテキストを作成します。
参照トピック