既存のRPGプログラムへ新しい出力引数を追加したい。一方で、そのプログラムを呼ぶ処理が複数あり、すべてを同時に変更できないことがあります。
このときの論点は、引数を1つ増やせるかだけではありません。古い呼出しが引数を渡さなかったときに、追加した領域へ触らないことと、新しい呼出しで意図した結果を返すことの両方が必要です。
*NOPASSを付けるだけでは足りない
IBMはOPTIONS(*NOPASS)により引数を渡さない呼出しを許容できる一方、渡されたかを確認してから参照する責任はプログラム側にあると説明しています。省略可能な引数の後ろに引数を置く場合、その後ろの引数も省略可能にする必要があります。IBM:OPTIONS(*NOPASS)
定義を変えたら、その変数を読む箇所だけでなく、初期化・クリア・代入する箇所も確認します。「先に全部クリアする」処理で、省略された出力引数を書き換えようとすることも避けなければなりません。
説明用:2引数を残して、3つ目を追加する
通常のRPGプログラム呼出しを想定した、最小の説明例です。IBM i実機でのコンパイルとCALL試験は行っていません。実際に使う場合は呼出し方式・コンパイラー・型と長さをそろえ、専用環境で確認してください。
**free
ctl-opt dftactgrp(*no);
dcl-pi *n;
requestCode char(8) const;
resultCode char(2);
extraInfo char(20) options(*nopass);
end-pi;
// 説明用の固定値。実際の業務処理ではない。
resultCode = '00';
if %parms() >= 3;
extraInfo = 'DEMO';
endif;
*inlr = *on;
return;
この例では、3つ目の領域への書込みを条件内に置いています。旧呼出しは2引数、新呼出しは3引数という違いを、確認表にも明示します。
| 呼出し | 渡すもの | 確認すること |
|---|---|---|
| 旧呼出し | requestCode、resultCode | 従来の結果を維持し、追加領域へ触らない |
| 新呼出し | 上記にextraInfoを追加 | 追加結果が期待どおり返る |
この条件分岐があることだけで、既存プログラム全体の互換性が証明されたわけではありません。旧処理の戻り値や副作用も別に比較します。
*NOPASSと*OMITを混同しない
「引数を渡していない」と「引数の位置はあるが省略値を渡した」は、同じ扱いにしません。*OMITを許すインターフェースでは、その状態も含めた確認が必要です。
上の例は*OMITを許可していません。*NOPASSの説明へ、そのまま*OMITの呼出し例を追加しないでください。既存の呼出し元にどの指定があるかを調査してから、必要な方式を選びます。
%PARMSの前提と、型・長さも確認する
%PARMSは引数の個数を扱うもので、渡された領域の型や長さが正しいことを保証するものではありません。
また、IBMはバインド呼出しで必要な記述子が渡されない場合など、個数の取得を信頼できない条件を説明しています。異言語の呼出しや特殊なインターフェースへ、通常のRPG同士の例を無条件に当てはめないようにします。IBM:%PARMS
| 項目 | 確認内容 |
|---|---|
| 呼出し方式 | プログラムCALLか、バインドしたプロシージャーか |
| 型・長さ | 文字長、数値の桁・小数位置、可変長などが合うか |
| 渡し方 | 参照渡し・値渡しなどが定義と合うか |
| 引数数の取得 | %PARMSを使える前提を満たすか |
| 追加領域 | 省略時は参照・初期化・更新しないか |
| 呼出し元 | RPG以外や古い版が残っていないか |
CLの文字列リテラルは、見える文字数だけで判断しない
試験用のCALLへ短い文字列を書いたことと、受取り側が期待する長さの領域を渡せたことは別です。リテラルの扱いはCALLの仕様を確認し、呼出し側の変数宣言、型、長さ、受取り側の定義を並べます。「引用符の中が8文字だから、8バイトの引数だろう」という推測で一致としないようにします。
特に、呼出し元だけ短い変数へ変えた場合や、パスの最大長を広げた場合は、正常な短い値が通るだけでは不足です。空、境界長、境界超過、必要なら日本語を含む値について、定義とエラー時の扱いを確認します。文字数とバイト数を同じ意味で使わないことも大切です。ネイティブAPIの引数契約も同じ観点で点検できます。
互換性の試験は、新しい呼出しだけで終えない
少なくとも、旧呼出し・新呼出しの両方で、正常時と異常時を確認します。
- 旧呼出しの入力と戻り値が、変更前と一致する。
- 新呼出しでは、正常時の追加出力が返る。
- エラー時の追加出力も仕様どおりで、前回値を残さない。
- 追加領域を省略した経路が、エラー処理や後片付けからも触らない。
- 実際に使う呼出し方式と型・長さで確認する。
導入順序も決めます。新しい呼出し元だけが先に入り、呼ばれる側が古いままなら、新しい出力を期待できません。どの組合せを許容するかを明記し、プログラム名だけでなく実行版を確認します。
引数追加の互換性は、定義の1行ではなく、全参照箇所・呼出し元・導入順序・旧版との比較で確かめるものです。
旧呼出し・新呼出しを同じ入力で比べる試験設計
以下は本文の自作プログラムに対する試験案です。コンパイル・CALLは未実施で、期待値を示しています。既存の本番プログラムを呼ばず、外部更新を持たない検証用コピーと、型を明示した試験用呼出し元を用意します。
呼出し元を二つ用意する
- 旧側:8文字のrequestCodeと2文字のresultCodeだけを渡す。
- 新側:同じ2引数に、20文字のextraInfoを追加する。
requestCodeは架空のREQ00001とします。resultCodeは呼出し前に未更新と分かる2文字、extraInfoは20文字のXで埋めます。CLの短いリテラルから長さを推測せず、呼出し元の定義と受取り側を照合してください。
| ケース | 期待結果 | 確認の意味 |
|---|---|---|
| 旧側で2引数を渡す | resultCodeは00。追加領域へアクセスしない | 従来の呼出しを維持 |
| 新側で3引数を渡す | resultCodeは00。extraInfoはDEMOと残りの空白 | 追加出力と固定長を確認 |
| 旧側を同一ジョブで繰り返す | 結果が前回の引数有無に依存しない | 状態の持越しを確認 |
| 新側→旧側の順に呼ぶ | 旧側の終了処理から追加領域へ触らない | 正常経路以外の参照漏れを確認 |
「追加領域へアクセスしない」は、画面にエラーが出なかっただけでは証明できません。全参照箇所のレビューと、省略経路の試験・必要なデバッグ確認を組み合わせます。
本文の固定値例には業務エラーの分岐がありません。実際の改修で入力不正・API失敗・例外処理を追加するなら、その各経路について同じ2引数/3引数の組合せを作り、旧結果と追加出力の期待値を別に定義します。未対応の*OMITや異なる型を「異常系だから」と無造作に渡して試さないでください。
導入判定表には「旧呼出し元+新版は試験対象」「新呼出し元+旧版は追加出力を保証できず導入不可」など、許可する組合せを明記します。引数数だけでなく、実際の生成物と呼出し先の版まで一致して初めて、その組合せの合否を判断できます。

