Procedure DataFileCopy(datafile, acronym, copiedDatafile)

DataFileCopy

With the procedure DataFileCopy you can copy a data file stored within a data manager file, to another data file within the same data manager file.

DataFileCopy(
        datafile,      ! (input) element in the set AllDataFiles
        acronym,       ! (input) string
        copiedDatafile ! (output) element parameter into AllDataFiles
        )

Arguments

datafile

An element in the set AllDataFiles, AllCases or AllDataSets.

acronym

The name of the new data file to be created

copiedDatafile

On success, contains the element in AllDataFiles associated with the datafile into which the original data file was copied.

Return Value

The procedure returns 1 if the data file has been copied, and 0 otherwise.

Note

  • This function is only applicable if the project option Data_Management_style is set to Single_Data_Manager_file.

  • If a datafile with the given acronym already exists in the data manager file, the call to DataFileCopy will fail.