CBL_RENAME_FILE

ファイルの名前を変更します。

構文：

call "CBL_RENAME_FILE" using     old-filename
                                 new-filename
                       returning status-code

パラメーター：

old-filename: pic x(n)
new-filename: pic x(n)
status-code: 「説明の読み方」を参照してください。

入力パラメーター：

old-filename: 名前を変更するファイル。名前にはパス名を含めることもでき, or a specific MFDBFH datastore URL(see The Datastore URL for specific SQL URL syntax)、空白文字で終了します。パスを指定しない場合は、現在のディレクトリと見なされます。
このルーチンは、ワイルドカード文字を含むファイル名に対しては機能しません。
new-filename: 空白文字で終了する新しい名前。old-filename にパス名または URL を指定した場合は、この値にも同じパス名または URL を含める必要があります。一部のオペレーティングシステムでは、new-filename の名前のファイルがすでに存在する場合に、ファイル名を変更できないことがあります。

出力パラメーター：

なし

説明：

CBL_RENAME_FILE はストライプを認識しません。このルーチンをストライプ化したファイルで使用すると、ルーチンは、最初のストライプのみの名前を変更します。そのため、このルーチンは個々のストライプでのみ使用し、ストライプ名でストライプを参照します。

注: ストライプ化は非推奨です。下位互換性のみを目的として提供されています。代わりに IDXFORMAT"8" を使用することをお勧めします。

RETURN-CODE を調べることで、呼び出しが成功したかどうかをチェックできます。詳細については、「ファイル状態コードとしての戻りコードの解釈」を参照してください。