AS400 CPFエラーの調べ方｜ジョブログで原因メッセージを確認

2026.04.30

CPFエラーが出た時は、画面に見える最後の1行だけで原因を決めず、ジョブログの前後を確認します。 メッセージID、発生ジョブ、直前の処理、対象プログラム、ファイル、ライブラリ、権限、ロックを順に見ると、修正が必要なのか、環境や運用の問題なのかを分けやすくなります。

CPFエラー調査の確認順をチームでそろえたい場合は、法人向けAS400 / IBM i Codex研修の内容・料金も確認できます。

CPFエラーとは

CPFはIBM iが返すメッセージIDの代表的な接頭辞です。オブジェクトが見つからない、ファイルを開けない、権限が足りない、コマンドの指定が誤っているなど、さまざまな場面でCPFメッセージが出ます。

接頭辞主な意味最初に見る場所
CPFIBM iのコマンド・オブジェクト・ファイルなどのメッセージジョブログ、メッセージ詳細
RNXRPG実行時エラージョブログ、RPGソース、データ
MCHマシン・実行環境に関する例外ジョブログ、呼び出しスタック
MSGWジョブがメッセージ応答待ちの状態WRKACTJOB、DSPMSG、ジョブログ

番号から探す場合は CPFエラー一覧、種類を横断して探す場合は メッセージID・エラーコード索引 を使ってください。

最初の5分で確認すること

  1. 発生日時と利用者の操作を確認する
  2. CPF番号と表示された文言を控える
  3. 対象ジョブのジョブ名・ユーザー・番号を確認する
  4. ジョブログで最初の原因メッセージまで戻る
  5. 対象プログラム、ファイル、ライブラリを確認する
  6. 同じエラーが繰り返すか、1回だけかを分ける
  7. 帳票、CSV、夜間バッチ、後続処理への影響を確認する

ジョブログは最後のエラーから前へ戻る

最後に出たCPFメッセージが「処理できなかった結果」で、その前に本当の原因が出ていることがあります。DSPJOBLOGやWRKJOBで詳細メッセージを表示し、直前のCALL、ファイル操作、MONMSG、ライブラリ変更まで戻ります。

DSPJOBLOG
WRKJOB JOB(123456/USERA/JOBNAME)
DSPMSGD RANGE(CPF4101) MSGF(QSYS/QCPFMSG)

自分の対話ジョブならDSPJOBLOG、別ジョブならジョブ名・ユーザー・番号を明示します。終了済みジョブではQPJOBLOGのスプールも確認します。

よくある原因と確認先

原因候補確認すること次に使うもの
オブジェクト未検出名前、タイプ、ライブラリ、ライブラリリストWRKOBJ、DSPOBJD、DSPLIBL
ファイルを開けない対象ファイル、メンバー、OVRDBF、実行環境DSPFD、DSPFFD、DSPJOB
権限不足実行ユーザー、所有者、オブジェクト権限DSPOBJAUT
ロック保持ジョブ、対象オブジェクト、待機状態WRKOBJLCK、WRKACTJOB
パラメーター不一致CALL元と先の桁数、型、順番RPG/CLソース、コンパイルリスト
環境差本番・検証、ライブラリリスト、ジョブ記述DSPJOB、DSPJOBD、DSPLIBL

メッセージIDだけで修正を決めない

同じCPF番号でも、発生したプログラム、ライブラリ、ジョブ、直前の処理によって原因は変わります。コード検索の結果をそのまま対処手順にせず、実際のジョブログと対象オブジェクトを照合します。

たとえばCPF4101でファイルが見つからない場合でも、ファイル未作成、ライブラリリスト違い、OVRDBFの向き先、コンパイル環境と実行環境の差などを分けて確認します。具体例は CPF4101の調査例 にまとめています。

後続処理を止めるかはCL全体で判断する

CPFエラーが出たからといって、すぐに後続処理を止める、または再実行するとは限りません。CLでMONMSGして想定内のメッセージとして扱っている場合もあります。反対に、前処理が失敗したまま出荷・在庫・売上・請求の後続処理を流すと、データ不整合につながる場合もあります。

  • どのコマンド・プログラムでCPFが出たか
  • MONMSGで何を捕捉しているか
  • 後続CALLがどのファイルを読むか
  • 途中更新や送信済みデータがあるか
  • 再実行した場合に二重更新・重複送信が起きないか

原因確認と業務影響を分ける

確認軸見ること
技術的な原因ジョブログ、プログラム、ファイル、権限、ロック、環境
業務影響入力、帳票、CSV、EDI、夜間バッチ、翌朝業務
復旧条件修正、再実行、データ戻し、関係者確認
再発防止監視、チェックリスト、テスト、手順書、教育

調査メモに残す情報

  • 発生日時、環境、ジョブ名・ユーザー・番号
  • メッセージID、重大度、詳細文
  • 直前に実行した画面・コマンド・プログラム
  • 対象ファイル、ライブラリ、メンバー
  • 利用者、帳票、CSV、バッチへの影響
  • 実施した確認、変更、再実行と結果

接続情報、パスワード、APIキー、顧客名、個人情報、本番データを調査メモやAIへの入力へ残さないようにします。

若手・後任者へ教える場合

「CPF番号を検索する」だけでなく、ジョブログの前後、対象ファイル、後続処理、業務影響まで同じ順番で見せます。調査をチームで標準化し、Codexを使ったジョブログ整理まで扱う法人向け支援は、AS400 / IBM i Codex研修の内容・料金 で確認できます。

参考

まとめ

CPFエラーは最後の1行だけで判断せず、ジョブログの前後、対象プログラム、ファイル、ライブラリ、実行ユーザー、業務影響を確認します。原因と結果のメッセージを分けてから、修正、再実行、停止継続を判断します。

スポンサーリンク