Copy General File

Copies a source file to a destination file, optionally overwriting the destination file if it already exists.

 

Input Arguments

 

0

File Path or Embedded File

Source File Name

The path for the source file.

1

File Path or Embedded File

Destination File Name

The path for the destination file.

2

Boolean

Overwrite?

Indicates whether the destination file should be overwritten if it already exists.

_68">Return Arguments

None.

 

Returned Status

 

SUCCESS

The file was successfully copied.

FAILURE

The source file could not be found, or the source/destination path could not be accessed.

Remarks

This command supports both absolute paths (ex. C:\test.xit) and relative paths (ex. .\test.xit). If a rela- tive path is provided and the MP is embedded, the path will be relative to the current SA file location.

If the Overwrite? argument (Argument 2) is set to TRUE, and the destination file already exists, than the source file will be copied over the destination file. If this argument is set to FALSE and the destination file already exists, no change will occur.