genProperties
Java™ コードの生成時に、genProperties ビルド記述子オプションによって、Java ランタイム・プロパティーの生成場所 (存在する場合) が指定されます。また、場合によっては、リンケージ・プロパティー・ファイルを生成するかどうかも指定されます。 このビルド記述子オプションが有効であるのは、どの種類の出力も使用可能な Java プログラムを生成する場合、またはリンケージ・プロパティー・ファイルのみ使用可能な Java ラッパーを生成する場合に限ります。このビルド記述子オプションの効果は、j2ee、genProject、および genDirectory の各ビルド記述子オプションの値によって異なります。
- j2ee ビルド記述子オプションを NO に設定すると、EGL 生成によりプロパティー・ファイルが作成され、そのファイルに Java ランタイム・プロパティーが保存されます。 下記の『値』セクションでは、genProperties ビルド記述子オプションの値が、このプロパティー・ファイルにどのように影響するかについて説明しています。
- j2ee ビルド記述子オプションを YES に設定し、genProject ビルド記述子オプションを J2EE プロジェクトのロケーションに設定すると、EGL 生成によって、そのプロジェクトの J2EE デプロイメント記述子に Java ランタイム・プロパティーが追加されます。
- j2ee ビルド記述子オプションを YES に設定し、genProject ビルド記述子オプションではなく genDirectory ビルド記述子オプションを設定した場合は、EGL 生成によって、genDirectory で指定されたフォルダーに J2EE 環境ファイルが作成され、そのファイルに Java ランタイム・プロパティーが保存されます。
注: このよう方法でディレクトリーに生成するようにした場合、J2EE 環境ファイル内の Java ランタイム・プロパティーは、次回の生成時に自動的に更新されません。 J2EE 環境ファイルに含まれている XML コードは、J2EE プロジェクトに生成するよう選択した場合に、J2EE デプロイメント記述子に追加されます。 J2EE プロジェクトにコードをインポートする場合は、J2EE 環境ファイルから XML コードを手動でコピーして、J2EE デプロイメント記述子に貼り付ける必要があります。 J2EE 環境ファイルの名前は pgmAlias-env.txt です (pgmAlias は、プログラムまたはその他の論理パーツの名前を指します)。
- VGWebTransaction を生成する場合、プロパティーは、genProperties ビルド記述子オプションの値に応じて、rununit.properties ファイルまたは pgmAlias.properties ファイルに保存されます。
- j2ee ビルド記述子オプションを YES に設定し、genProject ビルド記述子オプションを J2EE 以外のプロジェクトのロケーションに設定すると、genDirectory ビルド記述子オプションを設定した場合と同じように、EGL によって J2EE 環境ファイルが作成されます。 J2EE 環境ファイルについては、前述のリスト項目に記載されている注を参照してください。
EGL 生成では、新規または変更済みのプロパティーが出力ファイルの末尾に追加されます。プロパティーを複数回設定すると、最後の設定のみが実行時に有効になります。
値
- NO (デフォルト値)
- ランタイム・プロパティーまたはリンケージ・プロパティーは EGL では生成されません。
- PROGRAM
- この設定の効果は次のとおりです。
- J2EE の外部で実行されるプログラムまたは論理パーツを生成している場合、あるいは VGWebTransaction プログラムを生成している場合、EGL によって、生成されるプログラムや論理パーツに固有のプロパティー・ファイルが生成されます。
そのファイルの名前は次のとおりです。
pgmAlias は、プログラムまたはその他の論理パーツの実行時の名前を指します。 このプロパティー・ファイルは、残りの生成出力と同じ場所 (genProject または genDirectory で指定されます) に生成されます。 後から別の出力を生成すると、このプロパティー・ファイルは更新されます。pgmAlias.properties - J2EE 内で実行されるプログラムまたはその他の論理パーツを生成している場合、このトピックで前述したとおり、J2EE デプロイメント記述子または環境ファイルに、EGL によって Java ランタイム・プロパティーが追加されます。
- J2EE の外部で実行されるプログラムまたは論理パーツを生成している場合、あるいは VGWebTransaction プログラムを生成している場合、EGL によって、生成されるプログラムや論理パーツに固有のプロパティー・ファイルが生成されます。
そのファイルの名前は次のとおりです。
- GLOBAL
- この設定の効果は次のとおりです。
- J2EE の外部で実行されるプログラムまたはその他の論理パーツを生成する場合、あるいは VGWebTransaction プログラムを生成している場合、実行単位を通して使用されるが、その実行単位の初期プログラムには指定されていないプロパティー・ファイルが、EGL によって生成されます。
プロパティー・ファイルの名前は rununit.properties です。このプロパティー・ファイルは、残りの生成出力と同じ場所 (genProject または genDirectory で指定されます) に生成されます。
後から別の出力を生成すると、このプロパティー・ファイルは更新されます。
実行単位の最初のプログラムが、ファイルにもデータベースにもアクセスしない代わりに、 同じ実行単位内のプログラムまたはその他の論理パーツを呼び出してアクセスを行うような場合に、このオプションが特に役立ちます。
呼び出し側プログラムを生成する場合、 そのプログラム用に指定されるプロパティー・ファイルを作成したり、 内容にデータベース関連のプロパティーを含まないようにすることができます。呼び出し先プログラムを生成する場合、rununit.properties を生成することができます。 その内容は、両方のプログラムで使用可能です。
- J2EE 内で実行されるプログラムまたはその他の論理パーツを生成している場合、このトピックで前述したとおり、J2EE デプロイメント記述子または環境ファイルに、EGL によって Java ランタイム・プロパティーが追加されます。
- J2EE の外部で実行されるプログラムまたはその他の論理パーツを生成する場合、あるいは VGWebTransaction プログラムを生成している場合、実行単位を通して使用されるが、その実行単位の初期プログラムには指定されていないプロパティー・ファイルが、EGL によって生成されます。
プロパティー・ファイルの名前は rununit.properties です。このプロパティー・ファイルは、残りの生成出力と同じ場所 (genProject または genDirectory で指定されます) に生成されます。
後から別の出力を生成すると、このプロパティー・ファイルは更新されます。
PROGRAM と GLOBAL のどちらを指定した場合でも、Java ラッパーまたは呼び出し側プログラムを生成する場合は、リンケージ・プロパティー・ファイルが EGL によって生成される場合があります。 このファイルが生成される状況について詳しくは、トピック『リンケージ・プロパティー・ファイル』を参照してください。
Java ランタイム・プロパティーについては、トピック『Java ランタイム・プロパティーの概要』および『リンケージ・プロパティー・ファイル』に、より詳しい情報が記載されていますので参照してください。