IBM iからファイルサイズを取得する処理を作るとき、「容量」という言葉だけでは、何を返せばよいか決まりません。ファイル内容のバイト数を知りたいのか、割り当てられた領域を知りたいのかで、見る値が違うからです。
さらに、IFSに見えるパスでも、ローカルのストリームファイルとQNTC配下の共有ファイルで、利用できる取得方法が同じとは限りません。
最初に「何のサイズか」を決める
IBMのIFS_OBJECT_STATISTICSの説明では、次の値が区別されています。IBM:IFS_OBJECT_STATISTICS
| 項目 | 確認したいこと |
|---|---|
| DATA_SIZE | オブジェクト内のデータのバイト数 |
| ALLOCATED_SIZE | オブジェクトへ割り当てられたバイト数 |
ファイル送信時の大きさを知りたいのに割当てサイズを使うと、意図しない値になる可能性があります。逆に、容量管理の目的なら、データ量だけでは必要な情報を満たさない場合があります。
また、ディレクトリー自身の値を、配下の全ファイルの合計だと解釈しないようにします。対象の種類と、集計の方法は別に確認します。
IFSにパスがあるだけで、SQL機能が対応するとは限らない
重要なのは、SQL機能の対象範囲です。IBMはIFS_OBJECT_STATISTICSについて、リモートファイルシステムのオブジェクトは行を返さず、QNTCでは/QNTC自体の行だけを返すと説明しています。IBM:リモートファイルシステムの制約
この制約がある機能でQNTC配下のファイルが一覧に出なくても、それだけで「ファイルが存在しない」とは判断できません。
まずパスが属するファイルシステムと、使う機能の対応範囲を確認します。取得できない機能へ同じパスを渡し続けるのではなく、そのパスで使えるAPIやアクセス方法を調べます。
0バイトと、取得失敗を同じ戻り値にしない
取得処理の設計では、少なくとも次を分けます。
| 状態 | 返す情報の考え方 |
|---|---|
| 正常に取得できた空ファイル | 成功とサイズ0 |
| パスが存在しない | 失敗と理由 |
| 権限や共有への接続で失敗 | 失敗と理由 |
| 利用機能の対象外 | 対象外と判断できる情報 |
| 値の表現範囲を超えた | 桁・型に関するエラー |
これらを全部0で返すと、呼出し元は「空なので処理不要」と誤判断するかもしれません。
APIを使って取得する場合も、サイズと成功状態を別に扱います。RPGの宣言・構造体・errnoの確認は、C APIの呼出し契約にまとめています。この記事では、どのサイズを、どの対象から取得するかに焦点を当てます。
単位変換は、元のバイト数も残す
画面へMB表示する場合は、1000単位か1024単位か、丸める桁はいくつかを決めます。仕様上必要なら、MBとMiBも区別します。
例えば説明用に、取得した値が1,048,576バイトなら、1024で2回割ると1です。一方、1000で2回割れば1.048576になります。どちらの値を使ったかを表示や項目名で分かるようにします。
比較や判定には元のバイト数を残し、丸めた表示値だけで「同じサイズ」と判定しないようにします。
取得処理の試験表
| 試験対象 | 確認したいこと |
|---|---|
| ローカルの既知サイズのファイル | 基準値と一致するか |
| 正常な0バイトのファイル | 失敗と区別できるか |
| 存在しないパス | 理由を返し、古い結果を使わないか |
| 権限不足・接続失敗 | サイズ0として扱わないか |
| QNTCなど別ファイルシステム | 選んだ方法の対応範囲を満たすか |
| 空白や日本語を含むパス | 渡し方と文字の扱いが正しいか |
| 大きなファイル | 取得側・返却側・画面側で桁が不足しないか |
仕様の入口を「ファイル容量を返す」から、対象の種類・サイズの意味・失敗時の扱いを決めるへ変えると、呼出し元まで含めて一貫した処理にしやすくなります。
0バイトと取得失敗を分ける最小の試験組
以下は取得仕様を確かめるための自作例です。IBM iや共有サーバーでの実行は未実施です。既存の業務ファイルや共有権限を変更せず、管理者が認めた検証用の保存場所を使います。
基準ファイルを用意する
empty.binは0バイト、eight.binはASCII文字列ABCDEFGHだけの8バイトとします。後者へ改行やBOMが付くと8バイトではなくなるため、作成後にバイト数を確認します。存在しない名前は、検証領域内で存在しないことを確認した別名にします。
| 対象・条件 | 期待する状態 | サイズの扱い |
|---|---|---|
| ローカルのempty.binを正常取得 | 成功 | DATA_SIZEは0を期待 |
| ローカルのeight.binを正常取得 | 成功 | DATA_SIZEは8を期待 |
| 存在しない名前 | 不在または取得失敗を識別 | 空ファイルの成功と区別 |
| QNTC配下をIFS_OBJECT_STATISTICSで照会 | 対応範囲外として評価 | 行なしをファイル不在の証拠にしない |
| API・接続処理が失敗 | 失敗と理由を返す | 直前の成功サイズを流用しない |
ALLOCATED_SIZEは8と一致することを期待しません。割当て単位や属性の違いがあるため、内容のバイト数の期待値を割当てサイズへ流用しないことが要点です。
正常の直後に失敗させる理由
eight.binの成功で8を返した後、存在しない名前を確認する順にします。二回目も「成功・8」なら、前回結果の残留を疑えます。「失敗・0」でも、状態を無視して0だけを呼出し元へ返していないかを確認します。失敗時のサイズ欄は未確定として扱い、正常な空ファイルと明確に区別してください。
QNTCに対する別APIの採用は、この表だけでは決まりません。対象ファイルシステムの対応、認証、文字コード、大容量時の型を確認し、そのAPIで同じ基準ファイルの試験を改めて行う必要があります。

