仕様書がないAS400ブラックボックス化の見える化手順

AS400・IBM i

現場でよく聞かれる声

「この帳票の集計ロジック、どうやって計算しているか分かる人はいますか?」
「前の担当者が退職してから、仕様書がどこにも見当たらなくて……ソースコードを見るしかないですね」
「下手にプログラムを直して他の処理が止まったら怖いので、そのまま触らずに運用しています」

基幹システムとしてAS400(IBM i)を長年運用している企業の社内では、このようなやり取りが日常的に交わされています。

何が起きているのか

多くの中小企業で、10年〜20年以上にわたり機能追加や修正を重ねてきたAS400(IBM i)の業務アプリケーションに、最新の設計書や仕様書が残っていないケースが相次いでいます。
担当者の交代や開発ベンダーの変更を経るうちにドキュメントの更新が途絶え、どのプログラムがどのデータを更新しているのか全体像を把握できない「ブラックボックス化」が進行しています。
見える化を行わないまま法改正対応の改修や他システム連携、クラウド移行などに踏み切ると、隠れた依存関係によって別の業務処理が停止したり、データの不整合が起きたりする重大なリスクを抱えることになります。

本当の原因

問題は「古いシステムに最新の仕様書が残っていないこと」ではなく、実は「実稼働しているプログラムやデータのつながりを客観的に棚卸しする手順を持たないまま、個人の記憶や勘に頼って運用を続けてきたこと」です。

長年の現場対応のなかで「動くから触らない」「急ぎの修正だからドキュメントは後回しにする」という判断が積み重なると、どんなシステムでも必ず中身が見えなくなります。紙やExcelの古い設計書を探し回るよりも、今まさに本番環境で動いている資産そのものから事実を抽出する仕組みに切り替えることが本質的な解決策です。

自社はどれ?ブラックボックス化の4タイプ

自社のAS400(IBM i)がどの段階にあるのか、以下の4つのタイプに当てはめて確認してみてください。

タイプ1:まだ何もしていない(現状把握ゼロ型)

稼働中のプログラム数やライブラリー(プログラムやデータをまとめて管理するフォルダーのような単位)の構成すら一覧化できていない状態です。
具体例:サーバー室でAS400(IBM i)が毎日動いていることは分かるものの、どのライブラリーに本番用とテスト用のプログラムが混在しているか把握できていないケースです。

タイプ2:古い紙やExcelの仕様書だけが残っている(ドキュメント形骸化型)

導入当初の分厚いバインダーや10年以上前の設計書はあるものの、その後の改修履歴が反映されておらず実態と食い違っている状態です。
具体例:仕様書どおりの前提で外部連携の改修を進めたところ、実際には途中の年度で追加された別のプログラムがデータを書き換えており、テストで数値が合わなくなるケースです。

タイプ3:ソースコードはあるが依存関係が追えない(迷路化型)

RPG(IBM iで広く使われる業務アプリケーション開発言語)やCL(制御言語:ジョブやバッチ処理を制御する言語)のソースコードは残っているものの、呼び出し関係が複雑すぎて影響範囲を特定できない状態です。
具体例:1つの画面や夜間バッチから数十本のサブプログラムと物理ファイル(PF:データを格納するテーブル)、論理ファイル(LF:データの並び順や抽出条件を定義するビュー)が連鎖しており、1か所直すだけでどこに影響が出るか追いきれないケースです。

タイプ4:ソースコード紛失・コンパイル済みオブジェクトのみ残存(最重度ブラックボックス型)

本番稼働している実行用オブジェクト(IBM i上でプログラムやファイルなどを管理する単位)はあるものの、対応するソースコードが見当たらない、あるいは異なるバージョンのソースが混在している状態です。
具体例:過去に外注先へ改修を依頼した際、本番環境へオブジェクトだけが納品され、最新のソースメンバーが社内のソース物理ファイルに反映されていないケースです。

今やるべきこと:安全に進める見える化手順とタイプ別チェックリスト

AS400(IBM i)の見える化は、本番環境のデータやプログラムを変更しない「参照・抽出のみ」の調査から始めるのが鉄則です。まずは基本の4ステップを押さえたうえで、自社タイプのチェックリストに沿って進めてください。

ブラックボックス見える化の基本4ステップ

  1. ステップ1:稼働資産の棚卸し(使われているものと使われていないものの切り分け)

    IBM iの標準コマンドであるDSPOBJD(オブジェクト記述の表示)やSQLサービス(IBM iのシステム情報をSQLで照会できる機能)のQSYS2.OBJECT_STATISTICSを活用し、全ライブラリー内のオブジェクト一覧と最終使用日・最終変更日を抽出します。何年も使われていない旧プログラムやテスト用コピーを除外するだけで、調査対象を大きく絞り込めます。

  2. ステップ2:ソースコードの有無と整合性の照合

    稼働中のプログラムオブジェクトと、ソース物理ファイル内のソースメンバーを突き合わせ、ソースの最終変更日時とオブジェクトのコンパイル日時が一致しているかを確認します。ソースが欠落しているプログラムがあれば、優先的に対処リストへ載せます。

  3. ステップ3:プログラムとファイルの依存関係(CRUD)の可視化

    DSPPGMREF(プログラムが参照しているファイルや他プログラムを一覧表示する標準コマンド)やソースコード解析ツールを使い、どのプログラムがどの物理ファイル(PF)・論理ファイル(LF)を参照・追加・更新・削除しているかを一覧表(CRUD図)に整理します。

  4. ステップ4:日次・月次バッチと業務フローへの紐づけ

    ジョブスケジュール(WRKJOBSCDE)やメニュー定義を確認し、抽出したプログラム群を「受注」「出荷」「請求」「在庫」といった実際の業務プロセス単位にグルーピングします。ここまで整理できれば、改修時の影響範囲を根拠をもって判断できるようになります。

タイプ別・今すぐ取り組むチェックリスト

  • 【タイプ1:まだ何もしていない】まず今週やること
  • 本番業務で使っているライブラリー名を書き出す
  • 権限のあるユーザーでログインし、オブジェクト一覧(オブジェクト名・種類・最終使用日)をCSVや一覧表に出力する
  • 過去1年以上一度も使用されていないオブジェクトの件数を把握する

  • 【タイプ2:古い仕様書のみ残存】1か月以内を目安にやること
  • 既存の仕様書一覧と、本番ライブラリー内の実稼働プログラム一覧を突き合わせる
  • 仕様書に記載がない新規プログラムや、最終変更日が仕様書より新しいプログラムに印をつける
  • 優先度の高い基幹業務(売上・請求・在庫など)から順に、実稼働プログラム基準の台帳へ作り直す

  • 【タイプ3:依存関係が追えない】1〜3か月以内を目安にやること
  • DSPPGMREFコマンドやリバースエンジニアリング(既存のプログラムやデータベース構造を解析して設計情報を逆算する手法)支援ツールで、プログラムとファイルの呼び出し関係を自動抽出する
  • 外部システムとCSV連携やFTP連携しているインターフェース箇所をすべて洗い出す
  • 夜間バッチのジョブ流れ図を1枚のシートにまとめ、処理順序と前提条件を明文化する

  • 【タイプ4:ソースコード紛失あり】まず今週〜1か月以内を目安にやること
  • ソースが存在しないプログラムオブジェクトの一覧を作成し、業務上の重要度(停止すると業務が止まるか)を判定する
  • 過去のバックアップ媒体や開発ベンダー側の保管資産にソースが残っていないか照会する
  • どうしてもソースが復元できない重要プログラムについては、入出力ファイルと画面仕様から再構築またはパッケージ置換する方針を検討する

現場を経験したコンサルのアドバイス

AS400とは別の基幹システムの事例ですが、現在私が支援している企業でも、開発当初の仕様書しか残っておらず改修履歴が反映されていない状態でした。担当SEの退職後は本体の改修ができなくなり、周囲にサブシステムが派生していました。ベンダーに全コード解析を見積もると数千万円が提示されましたが、当時はAIも普及しておらず高額になりがちでした。同社は新パッケージへの移行を決めていたため、細かいコード解読よりも「どんなデータを入力し、どんな結果を出力しているか」という入出力の調査から着手しました。目的を絞って実稼働の事実から棚卸しを進めることが、無駄なコストを抑える近道です。

まとめ

「仕様書がないから怖くて触れない」という状態は、AS400(IBM i)の性能や寿命の問題ではなく、稼働資産とデータのつながりを棚卸しする手順が整っていないことから生じています。
いきなりすべてのプログラムを完璧にドキュメント化しようとすると途中で挫折してしまいます。まずは本番環境に影響を与えない標準コマンドや解析ツールを使い、「今使われている資産の棚卸し」と「ファイルとの依存関係の抽出」から一歩ずつ進めてみてください。仕組みとして見える化ができれば、1人情シス体制でも根拠をもって改修や次のシステム計画を判断できるようになります。

次の一歩

  1. まずは自社の稼働資産の棚卸しから始める

    自社のAS400(IBM i)で「どのライブラリーにいくつのプログラムがあり、直近1年でどれくらい使われているか」を確認するだけでも、ブラックボックスの輪郭がはっきりします。社内の情シス担当者や保守担当者と、まずは対象ライブラリーのリストアップから始めてみましょう。
  2. 解析の進め方やモダナイゼーション方針に迷ったら専門家に相談する

    自社だけでの棚卸しや影響範囲の調査が難しい場合や、見える化した後の保守体制・段階的なモダナイゼーション(既存資産を活かした最新化)の進め方を整理したい場合は、IBM i(AS400)の資産解析・運用支援に詳しい専門パートナーへ現状の棚卸し結果をもとに相談することをおすすめします。

参考

タイトルとURLをコピーしました