14.14 @@RTV_KEYSコマンド
@@RTV_KEYSコマンドは、指定されたファイル番号のすべてのキー・フィールドを取得して、要求されたリストに追加するために使用します。
指定するファイルは、@@GET_FILSコマンドで選択済みでなければなりません。また、リストは、@@CLR_LSTコマンドで定義/クリアされていなければなりません。
必須/省略可
@@RTV_KEYS ----- OF_FILE ----- 番号 ------------------------>
索引
>---- INTO_LST ---- 番号 ------------------------|
索引
パラメータ
キー・フィールドの取得元のファイル番号を指定します。この番号として、1文字または2文字の数値、あるいは2文字の索引名を指定できます。索引名を指定すると、このコマンドで現在の索引値が置き換えられます。索引の設定および使用については、@@SET_IDX、@@INC_IDX、@@DEC_IDX、@@CMP_IDXコマンドのセクションを参照してください。ファイル番号は、@@GET_FILSコマンドで選択済みでなければなりません。
フィールドの追加先のリスト番号を指定します。この番号として、1文字または2文字の数値、あるいは2文字の索引名を指定できます。索引名を指定すると、このコマンドで現在の索引値が置き換えられます。索引の設定および使用については、@@SET_IDX、@@INC_IDX、@@DEC_IDX、@@CMP_IDXコマンドのセクションを参照してください。リスト番号は、@@CLR_LSTコマンドで定義済みでなければなりません。
例
以下は、@@RTV_KEYSコマンドの例です。
例1：ファイル1からすべてのキー・フィールドを取得してリスト1に追加します。
@@CLR_LST NUMBER(1)
@@RTV_KEYS OF_FILE(1) INTO_LST(1)
例2：ファイルCFからすべてのキー・フィールドを取得してリスト2に追加します。
@@CLR_LST NUMBER(2)
@@RTV_KEYS OF_FILE(CF) INTO_LST(2)