ローカル・プリプロセッサー・オプションの変数
プロジェクト・ビルドを一般化するため、プロパティー・グループの「ローカル COBOL 設定」ページまたは「ローカル PLI 設定」ページの「ローカル・プリプロセッサー」ページにあるいずれかのフィールドの変数を使用できます。
- ${bundle:packageName}/パス
- ローカル・プリプロセッサーが定義されている、解凍済みのバンドルまたはプラグインの場所。 この変数は、製品内にインストールされているローカル・プリプロセッサー・プラグインを指すために使用できます。 packageName はプラグイン名、path はプラグイン内のプリプロセッサーの場所です。
- ${project_loc}
- プロジェクトの場所。 これは、プロジェクトのディスク上にロケーションを追加するために使用できます。 プロジェクト内のフォルダーの名前をプリプロセッサーに渡す必要がある場合は、 ${project_loc}\folder1として指定できます。 プリプロセッサーを呼び出すと、${project_loc} は置き換えられます。
- ${rdz_cache_home}
- ローカル・プリプロセッサーをリモート・ファイルとともに使用する際は、ルート・キャッシュの場所に達することが必要になる場合があります。 この場所は、 ${rdz_cache_sysn}Developer for z/OS® 変数の説明に記載されているキャッシュの場所です。 この変数には、 FttRemoteTempFiles\RSE Connection Name サブフォルダーは含まれません。 リモート・ファイルのローカル構文検査用の BuildOutput フォルダーは、${rdz_cache_home} の場所にあります。 このフォルダーから、ローカル・プリプロセッサーが開始されます。制限:
- ローカル構文検査は推奨されません。 このアクションは、Windows でのみ使用可能です。
- ローカル構文チェックでは、シフトアウト シフトイン (SOSI) ソースはサポートされません。 ローカル構文チェックを行うために使用されるインポーターは、 UTF-8エンコーディング。 翻訳CP-930およびその他のSOSIソースUTF-8一部の文字の列の位置が変更され、この変更によって予期しないエラーが発生します。
- ${rdz_cache_sysn}
- リモート・ファイルでローカル・プリプロセッサーを使用する場合は、 Developer for z/OS ダウンロード・ロケーションにあるファイルを指すことが必要な場合があります。 この場所は、ワークスペースの場所によって決まります。 リモート・ファイルのローカル構文は、コンパイルの依存関係をダウンロードします。 ダウンロード場所は、 Developer for z/OS キャッシュの場所です。 リモート・ファイルのローカル構文検査を要求する場合は、プリプロセッサーがリモート・システムで実行されていなければなりません。 プリプロセスとコンパイルの組み合わせがリモート・システムで実行され、ビルド依存関係のリストが作成されます。 このリストは、ファイルで「依存関係の表示」操作を実行したときに表示されるのと同じファイル・リストです。 また、このリストは、「構文検査」>「ローカル」アクションで「依存関係を検査しますか?」ウィンドウの「従属ファイル」をクリックしたときに表示されるのと同じファイル・リストです。 これらのファイルは、キャッシュの場所にダウンロードされます。 ${rdz_cache_sysn} 変数を使用して、ファイルまたはフォルダーを指示することが必要になる場合があります。 例えば、データ・セット・メンバー USERID.A001.COPYLIB(MEM1) が従属ファイルのいずれかである場合、ローカル・プリプロセッサーが取り込めるようにするために、そのファイルのキャッシュの場所を指すことが必要になる場合があります。 これを行う 1 つの方法として、ダウンロードしたメンバーを含むフォルダーに対して環境変数を設定するという方法があります。 この変数は、プリプロセッサー環境変数の入力フィールド SET
SYSLIB=${rdz_cache_sysn}\USERID\USERID.A001.COPYLIBで設定できます。 データ・セットに対応するフォルダーの親は、そのメンバーを含むデータ・セット名の高位修飾子です。 変数 ${rdz_cache_sysn} は、キャッシュ Developer for z/OS の場所で置換されます FttRemoteTempFiles\RSE Connection Name。制限:
- ローカル構文検査は推奨されません。 このアクションは、Windows でのみ使用可能です。
- ローカル構文チェックでは、シフトアウト シフトイン (SOSI) ソースはサポートされません。 ローカル構文チェックを行うために使用されるインポーターは、 UTF-8エンコーディング。 翻訳CP-930およびその他のSOSIソースUTF-8一部の文字の列の位置が変更され、この変更によって予期しないエラーが発生します。
- ${resource_fn}
- プリプロセスされる現在のリソースの非修飾ファイル名。 プロジェクトをビルドしたとき、プロジェクト内に COBOL ファイルが3つ、 RED.cbl, WHITE.cbl、 BLUE.cbl あったとすると、プロジェクトビルド中の各プリプロセスで、その変数に値が割り当てられることになる。 この値は、RED、WHITE、または BLUE のいずれかになります。 この変数は、プロジェクトでプリプロセッサー値を指定するときに使用します。 例えば、 「プリプロセッサー出力ファイル名」 入力フィールドに ${resource_fn}_PP1.dek を指定すると、 BuildOutput フォルダー内の出力ファイル RED_PP1.dek、 WHITE_PP1.dek、および BLUE_PP1.dekに移動します。
- ${resource_loc}
- プリプロセスされるリソースのディスクの場所。 プリプロセッサーで、プリプロセスするためにディスク上のファイルの正確な場所が必要な場合、この変数を使用できます。呼び出されるとすぐに、ディスク上のリソースの場所の値は置き換えられます。 リモートファイルのローカル構文チェックを要求した場合、ローカルプリプロセッサオプションの ${resource_loc} の値は、キャッシュ Developer for z/OS 内のファイルの場所となります。制限:
- ローカル構文検査は推奨されません。 このアクションは、Windows でのみ使用可能です。
- ローカル構文チェックでは、シフトアウト シフトイン (SOSI) ソースはサポートされません。 ローカル構文チェックを行うために使用されるインポーターは、 UTF-8エンコーディング。 翻訳CP-930およびその他のSOSIソースUTF-8一部の文字の列の位置が変更され、この変更によって予期しないエラーが発生します。
- ${INSTDIR}
- 製品のインストール・ディレクトリー。 バージョン 14.1.4 またはそれより前のリリースでは、${INSTDIR} 変数を使用して製品のインストール・ディレクトリーを指すことができます。 この変数は、製品に同梱されているインクルード・プリプロセッサーを検索するために使用します。