変換報告書の使用

CVTRPGSRC コマンドで CVTRPT(*YES) パラメーターを指定した場合には、 変換援助プログラムは変換報告書を生成します。スプール・ファイル名は、TOFILE パラメーターに指定するファイル名と同じで す。

変換報告書は、次の 4 つの部分から成ります。

  1. CVTRPGSRC コマンドのオプション
  2. ソース・セクション
  3. メッセージ要約
  4. 最終要約

リストの最初の部分には、CVTRPGSRC で使用されたコマンド・オプションの 要約が入ります。 図 217 は、変換例のコマンドの要約を 示します。

図 217. サンプル変換報告書のコマンド要約
5722WDS V5R4M0 060210 RN          IBM ILE RPG                    ISERIES   02/08/15  20:41:35       PAGE      1
  コマンド . . . . . . . . . . . . :   CVTRPGSRC
    投入元 . . . . . . . . . . . . :     DAVE
 FROM ファイル . . . . . . . . . . :   QRPGSRC
    ライブラリー . . . . . . . . . :     MYLIB
 FROM メンバー  . . . . . . . . :   REPORT
 TO ファイル . . . . . . . . . . . :   QRPGLESRC
    ライブラリー . . . . . . . . . :     MYLIB
 TO メンバー  . . . . . . . . :   *FROMMBR
 ログ・ファイル  . . . . . . . . . :   *NONE
    ライブラリー   . . . . . . . . :
 ログ・メンバー  . . . . . . . . . :   *FIRST
 拡張コピー・メンバー  . . . . . . :   *NO
 印刷変換報告書  . . . . . . . . . :   *YES
 第 2 レベルのテキストの組み込み . :   *YES
 仕様テンプレートの挿入  . . . . . :   *YES

ソース・セクションには、通知、または、エラー・メッセージと関連付けられた行 が組み込まれています。 これらの行には SEU でのブラウズを容易にするために 1 桁目にアスタリスク (*) があります。 メッセージ要約には、3 つのメッセージ・タイプがすべて入っています。

特に関心があると思われる 2 つの通知メッセージは、次のものです。

プログラムの中のすべての /COPY メンバーは、対応する ILE RPG プログラムがエラーを起こさずにコンパイルするために、変換しなければなりません。同様に、CALL で関連付けられているすべてのメンバーを同時に 変換したい場合があります。 報告書のこの部分を使うと、これらのメンバーの識別に 役立ちます。 図 218 は、サンプル変換のソース・セクションを示しています。

図 218. 変換報告書のサンプル・ソース・セクション
5722WDS V5R4M0  060210 RN         IBM ILE RPG                                      ISERIES1    02/08/15 20:41:35       PAGE      2
  FROM ファイル  . . . . . . . . . :   MYLIB/QRPGSRC(REPORT)
  TO ファイル .. . . . . . . . . . :   MYLIB/QRPGLESRC(REPORT)
  ログ・ファイル . . . . . . . . . :   *NONE
                             変    換    報    告    書
   順序  <---------------------------- ソース仕様 -----------------------------------><----------- 注記 -------------------> PAGE
   番号  ....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8....+....9....+...10....+...11....+...12 行
  000002 C                   CALL      PROG1
*RNM0511 00 CALL 命令コードが見つかった。
  000003 C/COPY COPYCODE
*RNM0508 00 /COPY コンパイラー指示が見つかった。
  000004 C                   FREE      PROG2
*RNM0506 30 FREE 命令コードは RPG IV ではサポートされていない。

       * * * * *   ソ ー ス の 終 わ り   * * * * *

リストのメッセージ要約は、出されたいろいろなメッセージを示します。 SECLVL(*YES) を指定すると、 メッセージ要約に第 2 レベルのメッセージが現れます。 図 219 は、第 2 レベルの メッセージを含む、変換例のメッセージ・セクションを示します。

図 219. 変換報告書のサンプル・メッセージ要約
5722WDS V5R4M0  060210 RN         IBM ILE RPG                                      ISERIES1    02/08/15 20:41:35       PAGE      2
                        メ ッ セ ー ジ の 要 約
 MSG ID  SV 番号 メッセージ・テキスト
*RNM0508 00      1 /COPY コンパイラー指示が見つかった。
                   原因. . . . . : この RPG IV ソースを正しくコンパイルする
                     ためには、このソース・メンバーに入っている/COPY ソース・
                     メンバーも RPG IV に変換されていることを確認してください。
                   回復手順 . . . :  RPG IV でのコンパイルの前に、すべての
                     /COPY ソース・メンバーが変換されていることを確認してください。
                     場合によっては、/COPY コンパイラー指示を使用するソース・メンバー
                     の変換およびコンパイルを試みると、問題が起こる結果となる場合
                     があります。結果がこの状態になった場合には、/COPY メンバー
                     を変換されるソースに拡張するために、CVT RPG SRC コマンドの
                     EXPCPY パラメーターに *YES を指定してください。詳細については、
                    「ILE RPG プログラマーの手引き」を参照してください。
*RNM0511 00      1 CALL 命令コードが見つかった。
                   原因 . . . . . :   CALL 命令コードが入っている RPG 仕様が見つかり
                       ましたが、次のことが必要となる可能性があります。
                       -- 静的バインドの利点を生かすために CALL 命令コードを CALLB に
                       変更する。
                       -- 適用業務のすべてのプログラムを RPG IV に変換する。
                   回復手順 . . . :   静的バインドの利点を生かしたい場合には、CALL
                     命令コードを CALLB に変換してください。あるいは適用業務のすべての
                     プログラムを移行したい場合には、呼び出されるプログラムを RPG IV に
                     変換してください。
*RNM0506 30      1 FREE 命令コードは RPG IV ではサポートされていない。
                   原因 . . . . . :   RPG III または RPG/400 プログラムに、RPG IV で
                     サポートされていない FREE 命令コードが入っています。
                   回復手順 . . . :   FREE 命令を除去して、変換されたソースをコンパイル
                     する前に、プログラミング論理が影響を受けないように代替コードと
                     置き換えてください。
       * * * * *  メ ッ セ ー ジ の 要 約 の 終 わ り   * * * * *

リストの最終の要約は、メッセージおよびレコードの統計を提供します。 最終状況メッセージは、ジョブ・ログにも入れられます。 図 220 は、サンプル変換の最終の要約セクションを示しています。

図 220. 変換報告書のサンプル最終要約
                            最終の要約
 メッセージ合計:
   通知          (00) . . . . . . . :       2
   警告          (10) . . . . . . . :       0
   重大エラー    (30+)  . . . . . . :       1
    ---------------------------------  -------
   合計   . . . . . . . . . . . . . :       3
 ソース合計:
   元のレコードの読み取り数 . . . . . :       3
   変換済みレコードの書き出し数 . . . :       4
   出された最高重大度メッセージ   . . :      30
        * * * * *   最 終 の 要 約 の 終 わ り   * * * * *
        * * * * *   変 換 の 終 わ り   * * * * *