変換報告書の使用
CVTRPGSRC コマンドで CVTRPT(*YES) パラメーターを指定した場合には、 変換援助プログラムは変換報告書を生成します。スプール・ファイル名は、TOFILE パラメーターに指定するファイル名と同じで す。
変換報告書は、次の 4 つの部分から成ります。
- CVTRPGSRC コマンドのオプション
- ソース・セクション
- メッセージ要約
- 最終要約
リストの最初の部分には、CVTRPGSRC で使用されたコマンド・オプションの 要約が入ります。 図 1 は、変換例のコマンドの要約を 示します。
図 1. サンプル変換報告書のコマンド要約
5769WDS V5R2M0 020719 RN IBM ILE RPG ISERIES1 08/15/02 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 つの通知メッセージは、次のものです。
- RNM0508 — フラグ /COPY ステートメント
- RNM0511 — フラグ CALL 命令
プログラムの中のすべての /COPY メンバーは、対応する ILE RPG プログラムがエラーを起こさずにコンパイルするために、変換しなければなりません。同様に、CALL で関連付けられているすべてのメンバーを同時に 変換したい場合があります。 報告書のこの部分を使うと、これらのメンバーの識別に 役立ちます。 図 2 は、サンプル変換のソース・セクションを示しています。
図 2. 変換報告書のサンプル・ソース・セクション
5769WDS V5R2M0 020719 RN IBM ILE RPG ISERIES1 08/15/02 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 レベルのメッセージが現れます。 図 3 は、第 2 レベルの メッセージを含む、変換例のメッセージ・セクションを示します。
図 3. 変換報告書のサンプル・メッセージ要約
5769WDS V5R2M0 020719 RN IBM ILE RPG ISERIES1 08/15/02 20:41:35 Page 2
メ ッ セ ー ジ の 要 約
MSG ID SV 番号 メッセージ・テキスト
*RNM0508 00 1 /COPY コンパイラー指示が見つかった。
原因. . . . . : この RPG IV ソースを正しくコンパイルする
ためには、このソース・メンバーに入っている /COPY ソース・
included in this source member have also been converted to
RPG IV.
回復手順 . . . : RPG IV でのコンパイルの前に、すべての
/COPY ソース・メンバーが変換されていることを確認してください。
場合によっては、/COPY コンパイラー指示を使用するソース・メンバー
の変換およびコンパイルを試みると、問題が起こる結果となる場合
があります。結果がこの状態になった場合には、/COPY メンバー
を変換されるソースに拡張するために、CVT RPG SRC コマンドの
EXPCPY パラメーターに *YES を指定してください。詳細については、
「ILE RPG プログラマーの手引き」を参照してください。
*RNM0511 00 1 CALL 命令コードが見つかった。
原因 . . . . . : CALL 命令コードが入っている RPG 仕様が見つかり
operation codes have been identified because the user may
wish to:
-- 静的バインドの利点を生かすために CALL 命令コードを CALLB に
変更する。
-- 適用業務のすべてのプログラムを RPG IV に変換する。
回復手順 . . . : 静的バインドの利点を生かしたい場合には、CALL
命令コードを CALLB に変換してください。あるいは適用業務のすべての
プログラムを移行したい場合には、呼び出されるプログラムを RPG IV に
変換してください。
*RNM0506 30 1 FREE 命令コードは RPG IV ではサポートされていない。
原因 . . . . . : RPG III または RPG/400 プログラムに、RPG IV で
サポートされていない FREE 命令コードが入っています。
回復手順 . . . : FREE 命令を除去して、変換されたソースをコンパイル
する前に、プログラミング論理が影響を受けないように代替コードと
置き換えてください。
* * * * * メ ッ セ ー ジ の 要 約 の 終 わ り * * * * *
リストの最終の要約は、メッセージおよびレコードの統計を提供します。 最終状況メッセージは、ジョブ・ログにも入れられます。 図 4 は、サンプル変換の最終の要約セクションを示しています。
図 4. 変換報告書のサンプル最終要約
最終の要約
メッセージ合計:
通知 (00) . . . . . . . : 2
警告 (10) . . . . . . . : 0
重大エラー (30+) . . . . . . : 1
--------------------------------- -------
合計 . . . . . . . . . . . . . : 3
ソース合計:
元のレコードの読み取り数 . . . : 3
変換済みレコードの書き出し数 . : 4
出された最高重大度メッセージ . : 30
* * * * * 最 終 の 要 約 の 終 わ り * * * * *
* * * * * 変 換 の 終 わ り * * * * *