9.214 TEMPLATE_@@GET_FILS

この機能は、指定のベース・ファイル名から関連するすべてのファイルのリストを呼び出し元に戻します。

この組み込み関数は、機能上、指定のベース・ファイル名からファイルのリストを戻すという点で、アプリケーション・テンプレート・コマンド @@GET_FILSの最初のステップのように動作します。

テンプレートでは、コマンドによって、ユーザーに結果リストが表示され、ユーザーはそのリストから選択することができます。ただし、組み込み関数のバージョンでは、呼び出し元のRDMLファンクションにリストが戻されます。

アプリケーション・テンプレートでは、ユーザーは、ワークステーションでファイルの横にブランク以外の値を入力することによってファイルを選択します。 RDMLファンクションからこのアクションを実行するには、TEMPLATE_@@SET_FILS組み込み関数を使用します。

この組み込み関数は、START_FUNCTION_EDIT組み込み関数によってすでに編集セッションに入っているファンクションに対してのみ使用することができます。

注意：この組み込み関数には、そのオンライン・テンプレートである@@GET_FILSよりも非常に強い機能が備わっています。

基本的な違いは、このファンクションによって、より広範囲のファイル・アクセス経路リストを抽出できるという点です。オンライン・バージョンでは、ファイル・リスト全体で、基となる同じ物理ファイルを複数回抽出することはできません。ただし、この組み込み関数ではこのルールを緩和し、ベース・ファイルから始まるおよびベース・ファイルを含む1つのアクセス経路「チェーン」または「パス」で基となる同じ物理ファイルを複数回使用できないようにしています。

この制限は、アクセス経路の「チェーン」または「パス」内で「閉じた回路」または「無限ループ」が発生するのを防ぐために必要です。

このファンクションを使用する予定の開発者は、この組み込み関数を使用する簡単なテスト・ファンクションを設計することによって、指定のベース・ファイルからファイルを抽出し、結果のファイル・リストを表示してみることを強くお勧めします。これによって、このファンクションの特性を非常に簡単に検証し、理解することができます。

注記事項：この組み込み関数は、基本的にRDMLファンクションによる新しいRDMLファンクションの作成を可能にする非常に高度な機能にアクセスするために使用します。

これは、LANSA製品に関する深い知識を必要とする非常に特殊な領域です。この組み込み関数を「商用」アプリケーション（例：受注入力）で使用することは一般的ではなく、使用しないことをお勧めします。

この BIF は、9.2 開発環境のみで使用される組み込み関数です。

引数

番号	タイプ	必須/任意	記述	最小長	最大長
1	A	必須	後でEXECUTE_TEMPLATE組み込み関数によって使用されるアプリケーション・テンプレートの名前	1	10
2	A	必須	1 次ファイル名またはベース・ファイル名	1	10
3	N	任意	開始ファイル番号デフォルトは1です。	1	2
4	N	任意	終了ファイル番号デフォルトは50です。	1	2
5	A	任意	物理ファイルのみ Y またはNを指定してください。デフォルトはYです。	1	1
6	A	任意	1: 1の関係のみ Y またはNを指定してください。デフォルトはYです。	1	1

戻り値

番号

タイプ

必須/任意

記述

最小長

最大長

最小小数桁数

最大小数桁数

1

A

必須

戻りコード

OK = 操作が完了した

ER = 致命的なエラーが検出された

2

L

必須