Rational® Developer
for System z® にはローカル・インクルード・プリプロセッサーが含まれています。これによって、PL/I ディレクティブの %INCLUDE または COBOL COPY ステートメント以外のインクルード・ディレクティブを使用して、外部ソース・ファイルをプログラムに取り込むことができます。
始める前に
ローカル・インクルード・プリプロセッサーを使用する前に、ローカル・プロパティー・グループを作成し、それをローカル PL/I
ソース・ファイルまたはローカル・プロジェクトに関連付けておく必要があります。
このタスクについて
ローカル・インクルード・プリプロセッサーは、Rational Developer for System z インストール・パスの
bin ディレクトリーにあります。Windows の場合、ファイル名は
PPINCL01.EXE です。Linux の場合、ファイル名は
PPINCL01 です。
ローカル・インクルード・プリプロセッサーは、個々の PL/I プログラムとともに使用することも、1 つ以上の PL/I プログラムを含むローカル z/OS® プロジェクトとともに使用することもできます。
また、単体で使用することも、複数プリプロセッサーのビルド操作の一部として使用することもできます。
- インクルード・プリプロセッサーが、コンパイル前に呼び出される唯一のプリプロセッサーである場合、入力ファイルは、構文検査または依存関係の表示操作の対象として選択された COBOL または PL/I プログラムです。
- プロジェクトをビルドするためにインクルード・プロセッサーが呼び出されると、プロジェクト内の COBOL または PL/I の各プログラムが処理され、コンパイルされます。
この場合、入力ファイルは、処理される現在の COBOL または PL/I ソースです。
- インクルード・プリプロセッサーが複数プリプロセッサー操作の一部として呼び出され、前のプリプロセッサーの後に呼び出されると、インクルード・プリプロセッサーに対する入力ファイルは、前のアクティブ・プリプロセッサーからの出力ファイルになります。
このファイルは、前のアクティブ・プリプロセッサーの「プリプロセッサー出力ファイル名」入力フィールドにリストされているものです。
複数プリプロセッサー操作のセットアップについて詳しくは、複数のローカル・プリプロセッサーの使用を参照してください。
ローカル・インクルード・プリプロセッサーを使用するには、以下のようにします。
手順
- リソースまたはプロジェクトに関連するプロパティー・グループのプロパティー・グループ・エディターを開き、PL/I ページに移動します。
- 左のリストから、「ローカル・プリプロセッサー」をクリックし、「ローカル・プリプロセッサー」ページを開きます。
- プロパティー・グループに新規ローカル・プリプロセッサーを追加するには、「新規」をクリックします。
- 「ローカル・プリプロセッサー」ページの「プリプロセッサー・オプション」セクションにあるフィールドを完成させます。
- プリプロセッサー記述
- 「インクルード・プリプロセッサー」のように、説明を入力します。
- プリプロセッサー名 (完全修飾)
- インクルード・プリプロセッサーの絶対パス名を入力します。${INSTDIR} 変数を使用して、Rational Developer for System z インストール・ディレクトリーを指すようにすることができます。この変数は、インクルード・プリプロセッサーを検出するために使用されます。
- プリプロセッサー引数
- インクルード・プリプロセッサーは、以下の引数を使用することができます。
Linux プラットフォームでは、小括弧ではなく中括弧 { } を使用してプリプロセッサー・オプションを指定してください (例えば、TRACE{ON} や FORMAT{ON} のように)。
- プリプロセッサー出力ファイル名
- プリプロセッサー出力に使用するファイル名を指定します。このオプションを省略すると、出力ファイル名が生成されます。
- エラー・フィードバックのサポート
- このチェック・ボックスを選択すると、プリプロセッサーによって生成されたエラーがログに記録されます。
このチェック・ボックスを選択すると、「エラー・フィードバック XML ファイル名」フィールドが使用可能になります。このオプションはデフォルトで使用可能になっています。
- エラー・フィードバック XML ファイル名
- エラー・フィードバック用に生成される XML ファイルの非修飾名を指定します。
このオプションを省略すると、エラー・フィードバック XML ファイル名が生成されます。
- 環境変数 (set ステートメント)
- プリプロセッサーに渡される環境変数を指定します。
このフィールドには、SYSLIB の値が含まれていますが、インクルード・ファイルを含むフォルダーを指すように、この値を変更する必要があります。
SYSLIB 環境変数のパス長さは、4 K に制限されます。長さが 4 K を超えてもエラー・メッセージは発行されませんが、4 K より大きい SYSLIB ステートメントは、インクルード・プリプロセッサー・プログラムで構文検査操作が異常終了する原因になることがあります。
Linux の場合、export SYSLIB=/root/project1/includes のようにエクスポート・ステートメントを使用して環境変数を設定します。