RPGの小さいが便利な機能強化をさらに2つ:LIKE(*EXT)および%LOOKUPNE
現場へ出向くたびに、すべての荷物を背負って運ぶ必要はありませんし、検索するたびに、すべてを手作業で調べる必要もありません。IBM i 7.5および7.6向けの7月のPTFバッチ内の小さめの機能強化のうちの2つは、まさにそのような地味ながらも便利なものです。すなわち、ジョブが必要とするよりも多くの作業を行うのではなく、実際に必要とする部品のみを取り出せるようにするツールです。
免責事項:以下の例で使用されているキノコの名前およびファイル/フィールド名は、あくまでサンプル プログラムの動作の仕組みを分かりやすく説明するためのものです。実際に野生のキノコ類を採取したり摂取したりする際は、事前にご自身で十分に調べ、キノコ狩りの準備も入念に行い、安全性が確保されるようにしてください。
LIKE(*EXT):ファイル全体を持ち込むことなく1つのフィールドを借用する
IBMは、長年、多くのRPGプログラマーが我慢してきた小さな悩みの種を解決する、新たな形式のLIKEキーワードを追加しています。すなわち、外部ファイルまたは表示装置ファイル内の1つのフィールドとまったく同じように定義された変数が必要ということでした。その1つのフィールドの属性を借用するだけのためにファイル全体(または外部記述データ構造)を宣言する必要はありません。
この機能強化以前は、一般的なアプローチ(今日でもまだコミュニティのほとんどが取っていると思われるアプローチ)は、ファイルに対して外部記述データ構造を定義し、次いで、そのデータ構造内のサブフィールドをLIKEで参照して、スタンドアロン変数を定義することでした。
dcl-ds t_forageLogRec extname('MUSHLIB/FORAGE_LOG') qualified template end-ds;
dcl-s weightOunces like(t_forageLogRec.weightOunces);
dcl-s speciesName like(t_forageLogRec.speciesName);
それは問題なく機能しますが、それが意味するのは、FORAGE_LOG内のすべてのフィールドによるフルのデータ構造を宣言し、メモリーに保持するということです(率直に言って、ほとんどのRPGショップはメモリー使用量を気にしません)。そして、それは、それらのうちの2つのフィールドの属性を借用するだけのためのものです。LIKE(*EXT)では、スタンドアロン フィールドは、外部ファイル、データベース ファイル、または表示装置ファイル内の単一の名前付きフィールドの正確なデータ タイプ、長さ、CCSID、およびその他の属性をそのまま継承します。ファイル宣言も使い捨てのデータ構造も必要ありません。小数点以下の桁数が0の外部バイナリー フィールドでは、EXTBININTの設定は今まで通り適用されます。フルの外部記述構造を定義した場合にそうなるのと同様です。
LIKE(*EXT)では、スタンドアロン フィールドは、外部ファイル、データベース ファイル、または表示装置ファイル内の単一の名前付きフィールドの正確なデータ タイプ、長さ、CCSID、およびその他の属性を引き受けます。ファイル宣言は必要ありません。小数点以下の桁数が0の外部バイナリー フィールドでは、EXTBININTの設定は今まで通り適用されます。フルの外部記述構造を定義した場合にそうなるのと同様です。
最も単純な形式は、追加の2つのパラメーターだけ、すなわち外部フィールド名と外部ファイル名を取ります。たとえば、「MUSHLIB/FORAGE_LOG」というキノコ狩りログを保持していて、その表内の列と同じ属性を持ついくつかのスタンドアロン フィールドのみが必要だとします。ファイル全体を宣言する必要はありません。
dcl-s weightOunces like(*ext : 'WEIGHTOUNCES' : 'MUSHLIB/FORAGE_LOG');
dcl-s speciesName like(*ext : 'SPECIESNAME' : 'MUSHLIB/FORAGE_LOG');
dcl-s foragerRole like(*ext : '"Forager Role"' : 'MUSHLIB/FORAGE_LOG') inz(*extdft);
フィールド名は、短い名前(WEIGHTOUNCES)にすることも、代替名(SPECIESNAME)にすることも、さらには大文字小文字が混在する特殊文字入りの引用符付きの代替名("Forager Role")にすることもできる点に注目してください。ファイル名は、ライブラリー修飾('MUSHLIB/FORAGE_LOG')およびライブラリー リスト参照('*LIBL/FORAGE_LOG')など、通常の形式を受け入れます。
RPGの通常のデフォルトのinit値ではなく、ファイルのDDS/DDL定義からのフィールドの実際の初期化値が必要でしょうか。INZ(*EXTDFT)を追加すると、フィールドは、上述のforagerRoleで示したように、外部デフォルトを受け取ります。
ファイルに複数のレコード フォーマットがある場合、LIKE(*EXT)は、デフォルトで最初のフォーマットに設定しますが、オプションの3つ目のパラメーターとして特定のフォーマットを指定することができます。たとえば、あなたのショップの「MUSHDSPF」というキノコ トラッキング表示装置ファイルには、新たに見つかったものを記録するためのレコード フォーマットが1つあり、既存のカタログ項目を編集するためにもうひとつのレコード フォーマットがあるとします。そして両者は偶然にもSTATUSフィールドを共有します。
dcl-s newFindStatus like(*ext : 'STATUS' : 'MUSHDSPF' : 'NEWFINDFMT');
dcl-s catalogStatus like(*ext : 'STATUS' : 'MUSHDSPF' : 'CATALOGFMT');
そして、その外部定義よりも少し大きいまたは小さいフィールドが必要な場合、ストリングおよび数値型の両方向けに、長さ調整パラメーターはそれも処理します。
dcl-s biggerWeightOunces like(*ext : 'WEIGHTOUNCES' : 'MUSHLIB/FORAGE_LOG' :+2);
dcl-s speciesName like(*ext : 'SPECIESNAME' : 'MUSHLIB/FORAGE_LOG' : +20);
スタンドアロン変数向けに1つのフィールドの属性を取得するだけのために、これまで使い捨ての外部記述データ構造を定義してきたショップでは、これで間接的な手順を1段階省けます。そして、SQLプリコンパイラー側でも、独自のPTFがLIKE(*EXT)を同様にサポートするため、円滑にCRTSQLRPGIと連携します。
%LOOKUPNEと%TLOOKUPNE:異なる最初の要素を見つける
RPGの配列および表ルックアップ組み込み関数ファミリーには、2つの新メンバーが加わります。すなわち、検索引数に等しくない最初の要素を見つける、%LOOKUPNEと%TLOOKUPNEです。これは、既存の%LOOKUP/%LOOKUPxxおよび%TLOOKUP/%TLOOKUPxxファミリーを自然に補完するものです。このファミリーは、長い間、等しい、より大きい、より小さいといった比較をカバーしてきましたが、「この値と異なる最初の要素を提供」するように求めるすっきりした方法はありませんでした。この機能強化以前は、それを行うには、手動ループまたは回避ロジックを必要としました。今では、それが1回の組み込み呼び出しで可能になりました。
%LOOKUPNEおよび%TLOOKUPNEは、他の%LOOKUPxxおよび%TLOOKUPxxファミリーと同じパラメーターを取るので、%LOOKUPまたは%LOOKUPGT/%LOOKUPLTをすでに使用している場合は、構文的に新たに学ぶべきことはありません。以下は、Morel(アミガサタケ)ではない最初の要素を探して、キノコ狩りサンプルの配列をスキャンする例です。
dcl-ds specimens qualified dim(100);
locationName varchar(100);
species char(20);
end-ds;
dcl-s numSpecimens int(10);
dcl-s p int(10);
// Find the first specimen that is not a Morel
p = %LOOKUPNE ('Morel' : specimens(*).species : 1 : numSpecimens);
それは、皆さんが思うよりも頻繁に生じることです。たとえば、それ以外は均一な配列内の最初の例外、表内の最初の非デフォルト値、パターンを破る最初のレコードを見つけることです。これからは、よりすっきりしたアプローチができます。索引を取得するだけのためにDOW/FORループを繰り返すのではなく、それは他のルックアップBIFと一緒に1行コードとしてコーディングすることができます。
PTFを入手する
- IBM i 7.5:ILE RPGコンパイラー 5770WDS SJ10450(両方の機能強化をカバー)、CRTSQLRPGIでのLIKE(*EXT)のサポート 5770ST1 SJ10604
- IBM i 7.6:ILE RPGコンパイラー 5770WDS SJ10455、CRTSQLRPGIでのLIKE(*EXT)のサポート 5770ST1 SJ10603
- IBM i 7.6、TGTRLS(V7R5M0):ILE RPGコンパイラー 5770WDS SJ10460
RDiでの両機能強化のサポートは、今後のアップデートで提供されます。ドキュメンテーション全体は、更新された7.5および7.6向けの「ILE RPG 解説書」と「ILE RPG プログラマーの手引き」、およびIBMの「RPG Cafe」のLIKE(*EXT)および%LOOKUPNEのページに掲載されています。
したがって、現在もV7R4で開発を行っている場合や、開発したソフトウェアをV7R4システムに配布する場合は、それらをアップグレードしてからでないと、これらの機能強化を活用することはできません。

