C$FSCOPY

The C$FSCOPY library routine copies an indexed file by invoking the proper file handler functions.

FILE-PREFIX settings are ignored by this routine.

This routine is particularly suitable for copying files that reside on a remote file server like c-tree or isCOBOL File Server. In order to copy files on the local machine, C$COPY routine should be used instead.

Indexed files whose record is larger than 64KB are not supported by C$FSCOPY.

Syntax:

CALL "C$FSCOPY" USING inputFile                         outputFile                 GIVING returnCode

Parameters:

inputFile	PIC X(n)	Specifies the name of the indexed file to be copied. The name is passed as is to the file handler.
outputFile	PIC X(n)	Specifies the name of the indexed file to be created. The name is passed as is to the file handler.

Return code:

0	Operation successful.
1	An error occurred.

Examples:

Example - Make a backup copy of an indexed file

*> define retCode as pic s9(2)   call "c$fscopy" using "cust"                       "cust_bk"                giving retCode if retCode not = 0    display message "File backup has failed" end-if