CBL_COPY_FILE Routine

CBL_COPY_FILE creates a copy of an existing file.

Usage

CALL "CBL_COPY_FILE"
    USING SOURCE-FILE, DEST-FILE,
    GIVING COPY-STATUS

Parameters

SOURCE-FILE PIC X(n)

Contains the name of the file to copy. The name can contain a path and is terminated by a space. If no path is given, the current directory is assumed. Remote name notation is allowed for this parameter.

DEST-FILE PIC X(n)

Contains the destination file name. The name can contain a path and is terminated by a space. If no path is given, the current directory is assumed. Remote name notation is allowed for this parameter.

COPY-STATUS Any numeric type

Returns "0" if successful, or "1" if not.

Description

CBL_COPY_FILE creates an exact duplicate of SOURCE-FILE in DEST-FILE.

Note: The behavior of this library routine is affected by the setting of the FILENAME-SPACES configuration variable. See the documentation in Appendix H, Configuration File Entries, for information about the terminating character for path names.