ファイルの名前を変更します。
構文:
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
- 名前を変更するファイル。名前はパス名を含めることができ、空白文字で終了します。パス名を指定しない場合は、現在のディレクトリと見なされます。
このルーチンは、ワイルドカード文字を含むファイル名に対しては機能しません。
- new-filename
- 空白文字で終了する新しい名前。old-filename にパス名が含まれる場合は、この新しい名前に同じパス名を含める必要があります。一部のオペレーティング システムでは、new-filename の名前のファイルが既に存在する場合に、ファイル名を変更できないことがあります。
説明:
CBL_RENAME_FILE はストライプを認識しません。このルーチンをストライプ化したファイルで使用すると、ルーチンは、最初のストライプのみの名前を変更します。そのため、このルーチンは個々のストライプでのみ使用し、ストライプ名でストライプを参照します。
RETURN-CODE を調べることにより呼び出しが正常終了したかを確認できます。詳細については、「戻り値をファイルステータスとして解釈する」を参照してください。