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リリースによって異なるため、本番環境では自社のリリースに合わせて確認してください。
