AS400 / IBM i の保守で困るのは、資料がないことだけではありません。資料はあるのに古い、画面名と業務名が合わない、ジョブ一覧が更新されていない、ファイル定義と現行ソースがずれている、という状態もよくあります。棚卸しは、資料をきれいにする作業ではなく、保守で使える状態に戻す作業です。
棚卸しする資料
| 資料 | 確認すること | 使い道 |
|---|---|---|
| 業務一覧 | 業務名、担当部門、利用頻度 | 問い合わせの入口 |
| 画面一覧 | メニュー名、プログラム、権限 | 障害時の調査 |
| ジョブ一覧 | 夜間バッチ、投入時刻、依存関係 | 停止時の初動 |
| ファイル定義 | DSPFFD、キー、用途 | 影響調査 |
| 運用手順 | 再実行、戻し、連絡先 | 属人化防止 |
現行ソースとジョブログで裏取りする
古い設計書は、現行ソース、ジョブログ、スプール、利用部門へのヒアリングで裏取りします。資料に書いてあるから正しいのではなく、今の本番でどう動いているかを確認します。
完璧な資料より使える資料
最初から完璧な設計書を作ろうとすると止まります。まずは障害時に必要な業務名、ジョブ名、プログラム、ファイル、再実行手順を押さえた資料を作る方が効果的です。
古い設計書の調査は AS400の設計書が古い時の調査手順、引き継ぎは AS400担当者が退職する時の引き継ぎチェックリスト、影響調査は AS400 RPG/CL影響調査チェックリスト を参照してください。
Codexで資料化を速くする
Codexには匿名化した業務名、ジョブ名、確認結果を渡すと、棚卸し表や運用メモを整えやすくなります。機密情報を入れず、資料の型を作る用途で使うのが安全です。
関連: AS400のセキュリティ・運用改善・外部依頼を整理する場合は、AS400運用改善ロードマップ｜夜間バッチ・障害対応・資料化を順番に整える も確認してください。
関連: AS400引き継ぎ面談で聞く質問集｜担当者退職前に確認する業務・ジョブ・権限もあわせて確認してください。
古い資料を現行仕様と照合する例
設計書に「毎日23時実行」と書かれていても、現在の運用が同じとは限りません。文書名だけで棚卸しを終えず、実行中の仕組みと照合します。
| 確認点 | 確認内容 | 判断 |
|---|---|---|
| ジョブ運用 | 設計書の時刻と現行スケジュールを比較する | 差があれば承認済み仕様を確認して理由を記録する |
| プログラム | 資料に記載されたプログラム名と呼び出し元を確認する | 未使用、名称変更、代替済みを区分する |
| 連絡先 | 障害時の担当部署と承認者が在籍しているか確認する | 個人名だけでなく役割と代替連絡先を残す |
資料には最終確認日、確認者、根拠にした画面や設定、次回見直し日を付けます。更新できない資料は削除せず、旧版であることと参照禁止の理由を明記します。差分が見つかった場合は、資料だけでなく手順書や監視設定にも同じ古い記述が残っていないか横断確認します。
資料と実態が合っていない時、正解はソース
設計書や運用資料が実態と合っていないことは、AS400の現場ではよくあります。珍しい事故ではなく、長く動いているシステムでは普通に起きます。
理由は単純です。改修のたびに資料まで直されるとは限らないからです。緊急対応で先に直した、担当者が変わった、外部に委託した。どれも起こります。そして直っていない資料は、直っていないことが分からない形で残ります。
ではどこを正とするか。運営者の答えは明確で、結局、正解はソースです。資料は参考、動いているソースが仕様です。この順番を守らないと、資料に書かれた前提を信じたまま調査を進めて、後から辻褄が合わなくなります。
| 情報源 | 信頼度 | 扱い方 |
|---|---|---|
| RPG/CLソース | 正 | 迷ったらここへ戻る。実際に動いている処理 |
| ジョブログ・実行リソース | 高い | 実際に何が動いたかの記録。ソースの裏づけに使う |
| 設計書・仕様書 | 参考 | いつ時点のものか、その後の改修が反映されているかを疑う |
| 口頭の説明・引き継ぎメモ | 参考 | 意図を知る手がかりとしては有用。仕様の根拠にはしない |
ソースが正だからこそ、生成AIが活きる
ソースを正とする方針には、ひとつ現実的な問題があります。ソースを読むのは時間がかかるということです。何十年分の改修が積み重なったRPGやCLを、資料なしで追うのは重い作業です。だから多くの現場で、古い資料を頼りにする、詳しい人に聞く、といった回り道が選ばれてきました。
ここが、今の時代に変わったところです。生成AIによるソース解析が使えるようになったことで、「正解であるソースを読む」という本来の順番を、現実的な時間で回せるようになりました。処理の流れを整理させる、参照しているファイルを列挙させる、影響範囲の候補を出させる。資料の正しさを疑う代わりに、ソースから組み立て直すという進め方が取れます。
ただし、AIへ渡すものには線を引いてください。本番データ、顧客情報、認証情報、パスワード、APIキーは渡しません。渡すのは一般化したソースや構造の情報に限ります。
この進め方を現場で回せるようにする研修も用意しています。御社の環境とソースを使って、RPG/CLの読解から影響調査までを実際に行う形です。内容と料金はAS400 / IBM i Codex実戦研修の研修内容・料金で確認できます。
関連するAS400確認ルート
設計書や運用資料の棚卸しは、古い資料を捨てる作業ではなく、現行業務と障害対応に使える形へ整える作業です。AIで要約する場合も、元資料の所在と信頼度を先に分けます。
資料棚卸しは「最新か」より「使えるか」で見る
AS400の古い設計書は、日付が古くても現場で使えることがあります。逆に、新しい資料でも実際の運用と合っていないなら危険です。棚卸しでは、資料の有無だけでなく、現行画面、現行ジョブ、現行ファイル、業務担当者の説明と合っているかを確認します。
| 画面資料 | 現行メニュー、入力項目、権限と一致するか |
| バッチ資料 | 実行時刻、前後ジョブ、異常時対応があるか |
| ファイル資料 | DSPFFDの項目と説明が合っているか |
| 運用資料 | 担当者が実際に使っている手順か |