Rational Developer for System z バージョン 7.6

ローカル・インクルード・プリプロセッサーの使用

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 ソースです。
  • インクルード・プリプロセッサーが複数プリプロセッサー操作の一部として呼び出され、前のプリプロセッサーの後に呼び出されると、インクルード・プリプロセッサーに対する入力ファイルは、前のアクティブ・プリプロセッサーからの出力ファイルになります。 このファイルは、前のアクティブ・プリプロセッサーの「プリプロセッサー出力ファイル名」入力フィールドにリストされているものです。 複数プリプロセッサー操作のセットアップについて詳しくは、複数のローカル・プリプロセッサーの使用を参照してください。

ローカル・インクルード・プリプロセッサーを使用するには、以下のようにします。

  1. リソースまたはプロジェクトに関連するプロパティー・グループのプロパティー・グループ・エディターを開き、PL/I ページに移動します。
  2. 左のリストから、「ローカル・プリプロセッサー」をクリックし、「ローカル・プリプロセッサー」ページを開きます。
  3. プロパティー・グループに新規ローカル・プリプロセッサーを追加するには、「新規」をクリックします。
  4. ローカル・プリプロセッサー」ページの「プリプロセッサー・オプション」セクションにあるフィールドを完成させます。
    プリプロセッサー記述
    「インクルード・プリプロセッサー」のように、説明を入力します。
    プリプロセッサー名 (完全修飾)
    インクルード・プリプロセッサーの絶対パス名を入力します。${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 の値が含まれていますが、インクルード・ファイルを含むフォルダーを指すように、この値を変更する必要があります。

ご利用条件 | フィードバック

このインフォメーション・センターでは Eclipse テクノロジーが採用されています。(http://www.eclipse.org)