アプリケーション (application)
アプリケーションのプロパティーを定義します。
| 属性名 | データ型 | デフォルト値 | 説明 |
|---|---|---|---|
| autoStart | boolean | true | サーバーがアプリケーションを自動的に開始するかどうかを示します。 |
| context-root | string | アプリケーションのコンテキスト・ルート。 | |
| id | string | 固有の構成 ID。 | |
| location | ファイル、ディレクトリー、または URL。 | 絶対パス、またはサーバー・レベルのアプリケーション・ディレクトリーに対する相対パスで表されるアプリケーションのロケーション。 | |
| name | string | アプリケーションの名前。 | |
| suppressUncoveredHttpMethodWarning | boolean | false | アプリケーション・デプロイメント時に、対象とされない HTTP メソッドの警告メッセージを非表示にするオプション。 |
| type | string | アプリケーション・アーカイブのタイプ。 |
- application-bnd
説明: アプリケーションに含まれる一般デプロイメント情報を特定リソースにバインドします。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 version string アプリケーション・バインディングの仕様のバージョン。 - application-bnd > security-role
説明: 固有の構成 ID。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 id string 固有の構成 ID。 name string セキュリティー・ロールの名前。 - application-bnd > security-role > group
説明: 固有の構成 ID。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 access-id string グループ・アクセス ID id string 固有の構成 ID。 name string セキュリティー・ロールを処理するグループの名前。
- application-bnd > security-role > run-as
説明: 固有の構成 ID。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 id string 固有の構成 ID。 password リバース・エンコードされたパスワード (ストリング) Bean に別の Bean からアクセスするために必要なユーザーのパスワード。値は、平文形式またはエンコード形式で格納できます。パスワードをエンコードするには、securityUtility ツールで encode オプションを指定します。 userid string Bean に別の Bean からアクセスするために必要なユーザーの ID。
- classloader
説明: アプリケーション・クラス・ローダーの設定を定義します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 apiTypeVisibility string spec,ibm-api,api このクラス・ローダーから参照可能になる API パッケージのタイプ。spec、ibm-api、api、third-party を任意に組み合わせたコンマ区切りリスト。 classProviderRef 最上位の resourceAdapter エレメント (コンマ区切りのストリング) の参照のリスト。 クラス・プロバイダー参照のリスト。クラスまたはリソースを検索する際には、このクラス・ローダーはそれ自身のクラスパスの検索後に、指定されたクラス・プロバイダーに委任します。 commonLibraryRef 最上位の library エレメント (コンマ区切りのストリング) の参照のリスト。 ライブラリー参照のリスト。ライブラリー・クラス・インスタンスは他のクラス・ローダーと共有されます。 delegation - parentFirst
- parentLast
parentFirst このクラス・ローダーの前または後のどちらに親クラス・ローダーを使用するかを制御します。親が最初を選択して、クラスパスの検索前に直前の親に委任する場合。親が最後を選択して、直前の親に委任する前にクラスパスを検索する場合。 - parentFirst
- 親が最初
- parentLast
- 親が最後
privateLibraryRef 最上位の library エレメント (コンマ区切りのストリング) の参照のリスト。 ライブラリー参照のリスト。ライブラリー・クラス・インスタンスは、他のクラス・ローダーからのクラス・インスタンスに関係なく、このクラス・ローダーに固有です。 - classloader > commonLibrary
説明: ライブラリー参照のリスト。ライブラリー・クラス・インスタンスは他のクラス・ローダーと共有されます。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 apiTypeVisibility string spec,ibm-api,api このライブラリーのクラス・ローダーから参照可能になる API パッケージのタイプ。spec、ibm-api、api、third-party を任意に組み合わせたコンマ区切りリスト。 description string 管理者用の共有ライブラリーの説明 filesetRef 最上位の fileset エレメント (コンマ区切りのストリング) の参照のリスト。 参照されるファイル・セットの ID id string 固有の構成 ID。 name string 管理者用の共有ライブラリーの名前 - classloader > commonLibrary > file
説明: 参照されるファイルの ID必須: falseデータ型: 属性名 データ型 デフォルト値 説明 id string 固有の構成 ID。 name ファイルのパス 完全修飾ファイル名
- classloader > commonLibrary > fileset
説明: 参照されるファイル・セットの ID必須: falseデータ型: 属性名 データ型 デフォルト値 説明 caseSensitive boolean true 検索で大/小文字を区別するかどうかを指示するブール値 (デフォルト: true)。 dir ディレクトリーのパス ${server.config.dir} ファイルを検索するベース・ディレクトリー。 excludes string 検索結果から除外するファイル名パターンのコンマ区切りリストまたはスペース区切りリスト。デフォルトでは、除外されるファイルはありません。 id string 固有の構成 ID。 includes string * 検索結果に組み込むファイル名パターンのコンマ区切りリストまたはスペース区切りリスト (デフォルト: *)。 scanInterval 期間 (精度: ミリ秒) 0 long と時間単位のサフィックス (h - 時間、m - 分、s - 秒、ms - ミリ秒 (例: 2ms、5s)) で表した、変更についてファイル・セットを確認するスキャン間隔。デフォルトでは使用不可です (scanInterval=0)。 正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、秒 (s)、またはミリ秒 (ms) が可能です。例えば、500 ミリ秒は 500ms と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1s500ms は 1.5 秒に相当します。
- classloader > privateLibrary
説明: ライブラリー参照のリスト。ライブラリー・クラス・インスタンスは、他のクラス・ローダーからのクラス・インスタンスに関係なく、このクラス・ローダーに固有です。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 apiTypeVisibility string spec,ibm-api,api このライブラリーのクラス・ローダーから参照可能になる API パッケージのタイプ。spec、ibm-api、api、third-party を任意に組み合わせたコンマ区切りリスト。 description string 管理者用の共有ライブラリーの説明 filesetRef 最上位の fileset エレメント (コンマ区切りのストリング) の参照のリスト。 参照されるファイル・セットの ID id string 固有の構成 ID。 name string 管理者用の共有ライブラリーの名前 - classloader > privateLibrary > file
説明: 参照されるファイルの ID必須: falseデータ型: 属性名 データ型 デフォルト値 説明 id string 固有の構成 ID。 name ファイルのパス 完全修飾ファイル名
- classloader > privateLibrary > fileset
説明: 参照されるファイル・セットの ID必須: falseデータ型: 属性名 データ型 デフォルト値 説明 caseSensitive boolean true 検索で大/小文字を区別するかどうかを指示するブール値 (デフォルト: true)。 dir ディレクトリーのパス ${server.config.dir} ファイルを検索するベース・ディレクトリー。 excludes string 検索結果から除外するファイル名パターンのコンマ区切りリストまたはスペース区切りリスト。デフォルトでは、除外されるファイルはありません。 id string 固有の構成 ID。 includes string * 検索結果に組み込むファイル名パターンのコンマ区切りリストまたはスペース区切りリスト (デフォルト: *)。 scanInterval 期間 (精度: ミリ秒) 0 long と時間単位のサフィックス (h - 時間、m - 分、s - 秒、ms - ミリ秒 (例: 2ms、5s)) で表した、変更についてファイル・セットを確認するスキャン間隔。デフォルトでは使用不可です (scanInterval=0)。 正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、秒 (s)、またはミリ秒 (ms) が可能です。例えば、500 ミリ秒は 500ms と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1s500ms は 1.5 秒に相当します。
- resourceAdapter
説明: アプリケーションに組み込まれているリソース・アダプター用の構成を指定します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 alias string ${id} リソース・アダプターのデフォルト ID をオーバーライドします。ID は、リソース・アダプターの構成プロパティー・エレメントの名前で使用されます。次に、その名前は、リソース・アダプターによって提供される任意のリソースの構成プロパティー・エレメントの名前を決定する際に使用されます。リソース・アダプターの構成プロパティー・エレメント名の形式は、properties.<APP_NAME>.<ALIAS> です。ここで、<APP_NAME> はアプリケーションの名前であり、<ALIAS> は構成される別名です。未指定の場合、別名はデフォルトで、リソース・アダプターのモジュール名になります。 autoStart boolean リソース・アダプターがリソース・アダプターのデプロイメント時に自動的に始動するのか、リソースの注入または検索時に遅れて始動するのかを構成します。 contextServiceRef 最上位の contextService エレメント (ストリング) の参照。 コンテキストがスレッドに取り込まれる方法および伝搬される方法を構成します。 id string この構成が適用される組み込みリソース・アダプター・モジュールの名前を指定します。 - resourceAdapter > contextService
説明: コンテキストがスレッドに取り込まれる方法および伝搬される方法を構成します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 baseContextRef 最上位の contextService エレメント (ストリング) の参照。 このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。 jndiName string JNDI 名 onError - IGNORE
- FAIL
- WARN
WARN 構成エラーに対応して実行されるアクションを 決定します。例えば、この contextService に securityContext が 構成されているが、セキュリティー・フィーチャーが有効になっていない 場合に、失敗にするのか、警告を発行するのか、それとも構成の不正部分を無視する のかを onError が決定します。 - IGNORE
- サーバーは、構成エラーが発生したときに、警告メッセージもエラー・メッセージも出しません。
- FAIL
- サーバーは、最初のエラー発生時に警告メッセージまたはエラー・メッセージを出してから、サーバーを停止します。
- WARN
- サーバーは、構成エラーが発生すると警告メッセージおよびエラー・メッセージを出します。
- resourceAdapter > contextService > baseContext
説明: このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 baseContextRef 最上位の contextService エレメント (ストリング) の参照。 このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。 id string 固有の構成 ID。 jndiName string JNDI 名 onError - IGNORE
- FAIL
- WARN
WARN 構成エラーに対応して実行されるアクションを 決定します。例えば、この contextService に securityContext が 構成されているが、セキュリティー・フィーチャーが有効になっていない 場合に、失敗にするのか、警告を発行するのか、それとも構成の不正部分を無視する のかを onError が決定します。 - IGNORE
- サーバーは、構成エラーが発生したときに、警告メッセージもエラー・メッセージも出しません。
- FAIL
- サーバーは、最初のエラー発生時に警告メッセージまたはエラー・メッセージを出してから、サーバーを停止します。
- WARN
- サーバーは、構成エラーが発生すると警告メッセージおよびエラー・メッセージを出します。
- resourceAdapter > contextService > baseContext > baseContext
説明: このコンテキスト・サービスにまだ定義されていないコンテキストを継承する 元となるベース・コンテキスト・サービスを指定します。必須: falseデータ型: com.ibm.ws.context.service-factory
- resourceAdapter > contextService > baseContext > classloaderContext
説明: クラス・ローダー・コンテキスト伝搬構成。必須: falseデータ型:
- resourceAdapter > contextService > baseContext > jeeMetadataContext
説明: タスクで使用可能なコンテキスト・タスクをサブミットするアプリケーション・コンポーネントの名前空間を作成します。必須: falseデータ型:
- resourceAdapter > contextService > baseContext > securityContext
説明: これが指定されると、作業イニシエーターのセキュリティー・コンテキストが作業単位に伝搬されます。必須: falseデータ型:
- resourceAdapter > contextService > baseContext > syncToOSThreadContext
説明: これが指定されると、作業単位の runAs サブジェクトの ID が オペレーティング・システム ID と同期されます。必須: falseデータ型:
- resourceAdapter > 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 コンテキストを作成します。
- resourceAdapter > contextService > jeeMetadataContext
説明: タスクで使用可能なコンテキスト・タスクをサブミットするアプリケーション・コンポーネントの名前空間を作成します。必須: falseデータ型:
- resourceAdapter > contextService > securityContext
説明: これが指定されると、作業イニシエーターのセキュリティー・コンテキストが作業単位に伝搬されます。必須: falseデータ型:
- resourceAdapter > contextService > syncToOSThreadContext
説明: これが指定されると、作業単位の runAs サブジェクトの ID が オペレーティング・システム ID と同期されます。必須: falseデータ型:
- resourceAdapter > 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 コンテキストを作成します。
- resourceAdapter > customize
説明: 指定されたインターフェースまたは実装クラス、あるいはその両方のアクティベーション・スペック、 管理対象オブジェクト、または接続ファクトリーの構成プロパティー・エレメントをカスタマイズします。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 implementation string 構成プロパティー・エレメントをカスタマイズする必要がある完全修飾実装クラス名。 interface string 構成プロパティー・エレメントをカスタマイズする必要がある完全修飾インターフェース・クラス名。 suffix string 構成プロパティー・エレメントのデフォルト・サフィックスをオーバーライドします。例えば、properties.rarModule1.CustomConnectionFactory の「CustomConnectionFactory」などです。サフィックスは、複数のタイプの接続ファクトリー、管理対象オブジェクト、またはエンドポイント・アクティベーションがリソース・アダプターによって提供されている場合に曖昧性を解消する際に役立ちます。構成プロパティー・エレメントのカスタマイズでサフィックスが省略されるか、ブランクのままにされた場合、サフィックスは使用されません。
参照トピック