DSPFFDの読み方|AS400で項目定義・桁数・型を確認する現場手順

DSPFFDは、AS400 / IBM i でファイルの項目定義を確認する時に使うコマンドです。項目名、桁数、型、小数桁、見出しを確認し、RPG/CL、帳票、外部連携、データ抽出とのズレを調べます。

ファイルの中身を見るDSPPFMと混同されがちですが、DSPFFDは「定義を見る」コマンドです。データの値ではなく、その値を入れる箱の形を確認します。

DSPFFDで見る項目

項目見る理由
フィールド名RPG/CLや帳票で参照している項目と照合する
桁数画面・帳票・CSVで桁あふれが起きないか見る
文字、数値、日付など扱い方を判断する
小数桁金額、数量、単価の計算誤差を防ぐ
見出し業務担当者に説明する時の手がかりにする

現場で多い確認場面

  • 画面の項目とファイル項目が合っているか確認する
  • 帳票の桁あふれや文字切れの原因を調べる
  • CSV出力前に項目の型と桁数を確認する
  • RPG修正時に参照項目の定義を確認する
  • EDI連携で相手先の桁数とズレていないか見る

DSPPFMと一緒に見る

DSPFFDで定義を確認したら、必要に応じてDSPPFMやSQLで実データを確認します。たとえば桁数は足りているのに画面表示が切れる場合は、プログラム側の編集や帳票レイアウトが原因かもしれません。

既存の詳しい比較はDSPFFDとDSPPFMの使い分け、データ抽出時の注意点はAS400データ抽出ガイドを確認してください。

DSPFFDは、項目名だけでなく桁数・型・小数桁まで確認する

DSPFFDは、AS400 / IBM i のファイル項目を調べる基本コマンドです。項目名だけを見て終わるのではなく、桁数、データ型、小数桁、開始位置、見出し、テキスト、キー項目との関係まで確認すると、RPGやCLの修正時に事故を減らせます。特に金額、数量、日付、コード値は、見た目より桁数や小数桁の扱いが重要です。

見る項目確認する理由現場での注意点
項目名RPGソースや画面項目との対応を見る略称だけで意味を決めつけない
型・桁数文字、数値、日付、パック10進の扱いを分ける桁あふれやゼロ埋めに注意
小数桁金額、単価、数量の丸めに影響する請求や在庫差異の原因になる
キー項目検索条件やJOIN条件に関係する順序と重複可否を見る
テキスト保守担当者が意味を推測する助けになる古い説明が現状と違う場合がある

項目定義を読む力は、AS400保守の基礎です。DSPFFDで項目を見た後は、実際にどのプログラムがその項目を更新しているか、画面や帳票でどう表示されるか、SQLで抽出する時に型変換が必要かまで確認します。若手教育では、DSPFFDの結果を見ながらRPGソース、DDS、SQLを行き来する練習をすると、現場での調査力が上がります。

まとめ

DSPFFDは、AS400のファイル定義を読むための基本コマンドです。項目名、桁数、型、小数、見出しを確認し、RPG/CL、帳票、CSV、EDIとのズレを見つける入口として使いましょう。

関連するAS400確認ルート

DSPFFDは、項目定義、桁数、型、キー、文字コードを確認する入口です。CSV、移行、外部連携、SQL更新の前提確認として使うと事故を減らせます。

DSPFFDは桁数だけでなく業務意味と合わせて読む

DSPFFDで項目定義を見る時は、桁数や型だけで終わらせません。得意先コード、品番、数量、金額、日付などは、桁数が合っていても業務意味が違うと障害になります。私は、画面項目、帳票、CSV、外部連携の項目名と見比べて、同じ意味で使われているかを確認します。

  • 項目名と見出しだけで判断しない
  • 小数桁、符号、ゼロ埋めを確認する
  • 画面・帳票・CSVで同じ意味か見る
  • 変更する場合は後続プログラムの参照も確認する

参考:IBM公式ドキュメント(DSPFFD)

本記事で扱った DSPFFD の全パラメーターと表示項目の定義は、IBM公式ドキュメントで確認できます。指定できる値や既定値はOSリリースによって異なるため、本番環境では自社のリリースに合わせて確認してください。