Rational® Developer
for System z® にはローカル・インクルード・プリプロセッサーが含まれています。これによって、PL/I ディレクティブの %INCLUDE または COBOL COPY ステートメント以外のインクルード・ディレクティブを使用して、外部ソース・ファイルをプログラムに取り込むことができます。
始める前に
ローカル・インクルード・プリプロセッサーを使用する前に、ローカル・プロパティー・グループを作成し、それをローカル PL/I
ソース・ファイルまたはローカル・プロジェクトに関連付けておく必要があります。
このタスクについて
ローカル・インクルード・プリプロセッサーは、Rational Developer for System z インストール・パスの
bin ディレクトリーにあります。ファイル名は、
PPINCL01.EXE. です。
ローカル・インクルード・プリプロセッサーは、個々の PL/I プログラムとともに使用することも、1 つ以上の PL/I プログラムを含むローカル z/OS® プロジェクトとともに使用することもできます。
また、単体で使用することも、複数プリプロセッサーのビルド操作の一部として使用することもできます。
- インクルード・プリプロセッサーが、コンパイル前に呼び出される唯一のプリプロセッサーである場合、入力ファイルは、構文検査または依存関係の表示操作に対して選択された COBOL または PL/I プログラムです。
- プロジェクトをビルドするためにインクルード・プロセッサーが呼び出されると、プロジェクト内の COBOL または PL/I の各プログラムが処理され、コンパイルされます。
この場合、入力ファイルは、処理される現在の COBOL または PL/I ソースです。
- インクルード・プリプロセッサーが複数プリプロセッサー操作の一部として呼び出され、前のプリプロセッサーの後に呼び出されると、インクルード・プリプロセッサーに対する入力ファイルは、前のアクティブ・プリプロセッサーからの出力ファイルになります。
このファイルは、前のアクティブ・プリプロセッサーの「プリプロセッサー出力ファイル名」入力フィールドにリストされているものです。
複数プリプロセッサー操作のセットアップについて詳しくは、複数のローカル・プリプロセッサーの使用を参照してください。
ローカル・インクルード・プリプロセッサーを使用するには、以下のようにします。
- リソースまたはプロジェクトに関連するプロパティー・グループのプロパティー・グループ・エディターを開き、PL/I ページに移動します。
- 左のリストから、「ローカル・プリプロセッサー」をクリックし、「ローカル・プリプロセッサー」ページを開きます。
- プロパティー・グループに新規ローカル・プリプロセッサーを追加するには、「新規」をクリックします。
- 「ローカル・プリプロセッサー」ページの「プリプロセッサー・オプション」セクションにあるフィールドを完成させます。
- プリプロセッサー記述
- 「インクルード・プリプロセッサー」のように、説明を入力します。
- プリプロセッサー名 (完全修飾)
- インクルード・プリプロセッサーの絶対パス名を入力します。${INSTDIR} 変数を使用して、Rational Developer for System z インストール・ディレクトリーを指すようにすることができます。この変数は、インクルード・プリプロセッサーを検出するために使用されます。
- プリプロセッサー引数
- インクルード・プリプロセッサーは、以下の引数を使用することができます。
- TRACE(ON|OFF) ワークステーションで、このオプションは TPF リモート・コンソールに追加出力を行います。390
システムでは、このオプションは追加の JES 出力を行います。この出力は、IBM® 技術サポート担当者によって使用されることを目的としたものです。これによって、不必要な出力量が増え、パフォーマンスが低下するため、通常の開発手順では使用しないでください。
問題判別のために IBM 技術サポート担当者に連絡を取る必要がある場合は、この出力をメールにコピーすることができます。
このオプションのデフォルトは TRACE(OFF) です。このオプションが指定されていない場合は、デフォルト値が使用されます。
- FORMAT(ON|OFF) ワークステーションおよび 390 システムで、このオプションは、エラー・メッセージに対して生成された XML の可読性を変更します。
FORMAT(ON) に設定すると、ステートメント表は 6 列で読み取られるようになり、この結果、XML ファイルの可読性が上がります。このオプションを設定すると、XML ファイル構文解析のパフォーマンスが大幅に下がるため、操作に要する時間がより長くなります。
このオプションのデフォルトは FORMAT(OFF) です。
このオプションが指定されていない場合は、デフォルト値が使用されます。
- プリプロセッサー出力ファイル名
- プリプロセッサー出力に使用するファイル名を指定します。このオプションを省略すると、出力ファイル名が生成されます。
- エラー・フィードバックのサポート
- このチェック・ボックスを選択すると、プリプロセッサーによって生成されたエラーがログに記録されます。
このチェック・ボックスを選択すると、「エラー・フィードバック XML ファイル名」フィールドが使用可能になります。このオプションはデフォルトで使用可能になっています。
- エラー・フィードバック XML ファイル名
- エラー・フィードバック用に生成される XML ファイルの非修飾名を指定します。
このオプションを省略すると、エラー・フィードバック XML ファイル名が生成されます。
- 環境変数 (set ステートメント)
- プリプロセッサーに渡される環境変数を指定します。
このフィールドには、SYSLIB の値が含まれていますが、インクルード・ファイルを含むフォルダーを指すように、この値を変更する必要があります。