AS400のRPGソース移送|SRCSEQ・SRCDAT・固定形式の確認手順

IBM iのソースメンバーをPCで編集して戻すとき、ソースの文字列だけを比較して「同じ」と判断していないでしょうか。

ソース物理ファイルのレコードには、本文だけでなくシーケンス番号や行の更新日を表す情報があります。また、固定形式のRPGなどでは、空白を含む桁位置が意味を持ちます。

この記事では、本文の変更と、転送による意図しない変更を分ける確認方法を整理します。実ソースは使用していません。

ソース物理ファイルには、本文以外の項目がある

IBMは、DDSを使わずCRTSRCPFで作成するソース物理ファイルについて、SRCSEQ、SRCDAT、SRCDTAの3項目を説明しています。IBM:Creating a source file without DDS

項目 意味
SRCSEQ ソースレコードのシーケンス番号
SRCDAT その行の最終更新日を表す情報
SRCDTA ソース本文

そのため、一般的なテキストファイルへ本文だけを書き出す方法と、3項目を保持して移送する方法では、保存できる情報が異なります。

同資料ではレコード長に番号と日付の12文字分を含めることも説明されています。転送先のデータ部分の長さを、レコード全体の長さと取り違えないようにします。

行の更新日と、本文右端の日付は別に比較する

ソースには、本文のコメントとして日付や変更識別子を書く運用もあります。それはSRCDATとは別の情報です。

例えば、更新日を維持するつもりでSRCDATだけを確認しても、本文の右端が切れていれば、コメントや識別情報を失うかもしれません。逆に、本文が同じでも、転送時に行番号や更新日が変わっている場合があります。

残す対象を「日付」と一括りにせず、レコード項目と本文内の情報を分けて定義します。

固定形式ソースを、見た目だけで整形しない

固定形式のコードでは、先頭の空白、指定欄、右側の欄など、位置が解釈に関係します。PC側のエディターや変換処理が次の操作をしないかを確認します。

  • 行頭や行末の空白を自動で削除する。
  • タブと空白を置き換える。
  • 長い行を分割する。
  • 文字コード変換で文字数・バイト数や内容が変わる。
  • 出力先の長さに合わせて末尾を切る。

全角文字を含む場合は、画面上の見た目の幅だけで判断しません。利用する文字コードやソース形式に沿って、内容と位置を確認します。

CPYSRCFなら、何も考えず同一になる?

CPYSRCFはソースファイルのコピー向けの機能を持ちますが、設定に応じた文字コード変換や置換動作を伴います。IBMは、コピー元と先のCCSID間で文字データを変換し、既定のメンバーオプションでは受信側の既存レコードを置き換えることを説明しています。IBM:Copy Source File

したがって、コマンド名だけで同一性を判断せず、コピー元・先、対象メンバー、置換条件、シーケンス番号の扱いを確認します。実行用コマンドを記事から無条件にコピーするのではなく、その環境で認められた手順を使います。

移送の前後を、同じ方法で取り出して比べる

比較は、次の3段階にすると整理できます。

段階 比較するもの
本文 行数、各行のSRCDTA、空白・右端を含む内容
レコード情報 SRCSEQ・SRCDATを保持する方針なら、その値
変更意図 今回変えた行と、変更しない行の差分

「余白を除去した本文」と「余白を保持した本文」のように、取り出し方が違うものをそのまま比較しないようにします。

行の更新日を新しくするなど、意図的に変える項目があるなら、先に許容差分として定義します。それ以外の差分がないかを確認し、転送した後に読み戻して比較します。

移送前後の確認メモ

対象のライブラリー/ファイル/メンバー:
ソース種別とデータ部分の長さ:
コピー元・先のCCSID:
SRCSEQ・SRCDATを保持/更新する方針:
本文内の日付・識別欄の扱い:
意図した差分:
移送後の読戻し方法:
意図しない差分の有無:
生成オブジェクトの確認:未実施/別途確認

ソースの読戻し一致と、コンパイル後の動作確認も別です。ソース移送では、まず意図した内容を正しく置けたことを確認し、その先の生成・実行確認へ進みます。

3行の自作メンバーで移送差分を確認する

以下は実コードではなく、移送方式を調べるための自作テキストです。実機移送は未実施です。承認された検証用メンバーへ用意し、既存の顧客ソースは上書きしません。

行 本文の用意 検出したい変化
1 先頭に半角空白を6個置き、その後にABC 行頭空白の削除
2 日本語と記号を含め、末尾に半角空白を3個置く 文字変換・末尾トリム
3 本文長Lの右端にZを置く。Lは実際のSRCDTA長以内 右端の切捨て

読戻しまでの手順

  1. 移送前にSRCSEQ・SRCDAT・SRCDTAを、空白を保持する同一の方法で取り出します。文字コードと本文長の測り方も記録します。
  2. 今回の移送方針を「番号・日付を保持」「意図的に採番・日付更新」のどちらかに定めます。後者なら許容する差分を先に書きます。
  3. 一つのメンバーだけを検証用の別名へ移送し、同じ取り出し方で読み戻します。
  4. 行数、各行の本文、先頭・末尾の空白、右端のZ、番号・日付を照合します。

保持方針なら、期待結果は3行の本文と番号・日付の一致です。日付だけを更新する方針なら、本文一致と許可した日付差分を分けて合格にします。CCSIDを変える経路では、元ファイルと先ファイルの生バイトが同じであることを一律の条件にせず、定義した変換後の内容と往復で失われない文字を確認します。

差分表は「行2:文字は一致、末尾空白が3個から0個」「行3:右端Zが欠落」のように残します。「見た目は同じ」「全体ハッシュが違う」だけより、転送条件とエディター設定のどちらを調べるべきか判断できます。この試験は移送の確認であり、RPGの構文や稼働版の一致を確認するものではありません。

関連する確認手順