AS400 / IBM i のRPGやCLを修正した時、コンパイルエラーだけを直して終わりにすると、参照ファイル違い、ライブラリリスト違い、古いソースの修正、後続影響の見落としにつながります。ここでは若手や引き継ぎ担当者でも追えるように、コンパイルエラーの見方を整理します。
コンパイルエラーで見る順番
| 確認 | 見るもの | 判断 |
|---|---|---|
| コンパイルリスト | スプール、エラー行、メッセージID | 文法か、参照先か、環境差か |
| ソース | 修正箇所、行番号、過去コメント | 本当に修正対象のソースか |
| 参照ファイル | DDS、外部記述、DSPFFD | 項目名や桁数が合っているか |
| ライブラリリスト | コンパイル時のLIBL | 本番と開発で違うものを見ていないか |
| 影響範囲 | 呼び出し元、後続処理、テスト観点 | コンパイル成功だけで終えてよいか |
スプールの先頭だけで判断しない
コンパイルリストでは、最初に出たエラーが本当の原因とは限りません。参照ファイルが見つからない、外部記述が違う、ライブラリリストが違うと、後続に大量のエラーが出ます。まず原因になっている最初の構造的なエラーを探します。
修正後は影響調査とテストをセットにする
RPG/CLは、1本の修正が請求締め、在庫更新、出荷確定、帳票出力に連鎖することがあります。コンパイル成功後は、呼び出し元、使用ファイル、画面、帳票、夜間バッチ、戻し手順まで確認します。
影響調査は AS400 RPG/CL影響調査チェックリスト、テスト証跡は AS400小改修後のテスト・エビデンスチェックリスト、本番反映は AS400本番反映・戻し手順チェックリスト にまとめています。
Codexで読む時の使い方
Codexに相談する時は、ソース全体や本番情報をそのまま渡すのではなく、匿名化したエラー行、メッセージID、該当する定義部分、確認したライブラリリストだけを渡します。AIは原因候補の整理には有効ですが、業務影響の最終確認は現場担当者が行います。
関連: AS400ライブラリリスト違いによる障害の調べ方｜開発・本番・テスト環境差を見るもあわせて確認してください。
関連: AS400 RPG/CLコードレビュー観点｜本番障害を減らすために見るポイントもあわせて確認してください。
コンパイルエラーは、文法だけでなくライブラリリストと業務影響を見ます
AS400 / IBM i のRPG/CLコンパイルエラーは、ソースの文法ミスだけで起きるわけではありません。参照しているファイル、コピー句、外部記述、ライブラリリスト、権限、コンパイル環境、オブジェクトの置き場所が違うだけでも失敗します。若手や外部エンジニアがつまずくのは、エラーメッセージだけを見て、業務で使われる本当の実行環境を確認しない時です。
現場では、まずスプールのエラー行、DSPFFDで参照ファイルの定義、DSPLIBLでライブラリリスト、既存オブジェクトの場所、変更前後のソース差分を確認します。Codexを使う場合は、コンパイルエラーの要約、原因候補の整理、確認コマンドの洗い出しに使うと効果があります。ただし、生成された修正案をそのまま本番反映せず、人がレビューして検証環境で確認します。
- RPG/CLソース解析とCodex要約で、読めないソースの整理方法を見る
- コマンド逆引きで、DSPFFD・DSPLIBL・WRKOBJを確認する
関連するAS400確認ルート
コンパイルエラーは修正して終わりではなく、関連コマンド、障害時の影響、基本操作へ戻って確認します。
RPGデバッグ・コンパイルコマンドで探す時の順番
「AS400 デバッグ」「RPG デバッグ」「コンパイル エラー 確認」「コンパイル コマンド」で調べている場合は、エラー行だけを追う前に、対象ソース、ライブラリ、コンパイル条件、参照ファイル、パラメータ、実行時ジョブログを分けて確認します。デバッグに入る前に、コンパイル時点の前提をそろえると原因を説明しやすくなります。
- RPGの読み方から戻る: RPG固定形式・フリーフォーマットの読み方
- 修正前の影響範囲を見る: RPG/CL影響調査チェックリスト
- ジョブログで実行時の原因を見る: CPFエラーとジョブログ確認
コンパイルエラーが止まった時の次アクション
RPG/CLのコンパイルエラーは、1件ずつ直すだけでなく、原因の説明を残すことで次回の調査時間を減らせます。エラー行、参照ファイル、変更前後の差分、ジョブログの内容を揃えておくと、保守会社への相談や若手への引き継ぎが進めやすくなります。
- ジョブログの基本は、AS400ジョブログ初心者向け確認手順で確認できます。
- CPFエラーと合わせて見る場合は、AS400 CPFエラーとジョブログ確認手順を使ってください。
コンパイルエラー対応を、変更管理の入口にする
RPG/CLのコンパイルエラーは、単にエラー行を直せばよいものだけではありません。参照ライブラリ、ソースメンバー、コピー句、ファイル定義、権限、コンパイルコマンド、リリース差異が絡むことがあります。エラー対応のたびに確認順を残しておくと、次の保守担当が同じ調査を繰り返さずに済みます。
ソース管理やレビューを始める時は、コンパイルエラーの記録を「どの変更で壊れたか」「どの環境では通るか」「戻し方はあるか」を整理する材料にできます。Codexを使う場合も、ソース全体や秘密情報を貼らず、エラー文、確認済み観点、匿名化した変更概要を整理する使い方が安全です。
参考：IBM公式ドキュメント（DSPFFD）
本記事で扱った DSPFFD の全パラメーターと表示項目の定義は、IBM公式ドキュメントで確認できます。指定できる値や既定値はOSリリースによって異なるため、本番環境では自社のリリースに合わせて確認してください。