4.16 CBL_RENAME

This routine changes the name of a file.

Specification

Parameter data definition

01  old-file-name  PIC X(n).
01  new-file-name  PIC X(n).
01  status-code    PIC S9(4) COMP-5.

Calling format

CALL "CBL_RENAME_FILE"
    USING old-file-name
          new-file-name
    RETURNING status-code.

Interface

old-file-name: Specifies the old name of the file, ending with a blank or null character. The maximum size of the file name is 255.

new-file-name: Specifies the new name of the file, ending with a blank or null character. The maximum size of the file name is 255.

Return code

The return code is set in the status-code specified in the RETURNING clause.

status-code

4.16 CBL_RENAME_FILE