[Files] Copy/Move
Q100007: [Files] Copy/Move
Copies or Moves files from one location to another. A location can be on any local filesystem with proper access permissions.
| Parameter | In/Out | Description | Other Info |
|---|---|---|---|
| File source | In | A single pathname, or list of pathnames (files) to process. An example being the FileList output variable from the [Files] Find module. |
|
| Copy or Move? | In | Choices: Copy, MoveCOPY files or MOVE (copy, then delete source) files(s)? |
Default: Copy |
| Destination folder | InOut | The folder to copy or move the file(s) to. | |
| Replicate subfolders? | In | Option to determine if subfolder structure from source should be replicated. | Default: False |
| Ignore same size? | In | Option to ignore copying eligible file(s) that already exist on the destination if filesize is same. | Default: False |
| Ignore same timestamp? | In | Option to ignore copying eligible file(s) that already exist on the destination if timestamp is same. | Default: False |
| Log output level | In | Choices: Minimal, VerboseThe level of execution detail you want to appear in the log. |
Default: Minimal |
| Processed file list | Out | List of pathnames (files) that were copied or moved. |
(Italics = required parameters)
Notes
The [Files] Copy/Move module allows you to copy or move files around the filesystems that are accessable to the JobServer. This includes local filesystems, such as on directly attached disk drives, as well as any connected networks with proper access rights. The files can be specified directly in the File Source parameter, or they can be supplied as a list of files output from a previous step. This is most commonly used with the [Files] Find module and that is used to select or pickup files from a general folder or network share.
The copy option works exactly as you might assume. The list of files provided are duplicated to the Destination Folder. If the Replicate Subfolders option is specified, then if the list of files is provided in FileList format, such as the [Files] Find module provides, then the hierarchy of files and folders will be copied from the source to the destination. If the move option is specified instead of copy, then the same thing happens with the additional step that all files which are successfully copied to the destination, are removed from the source.
If copying very large files, or copying files over a relatively slow network connection, you might be able to optimize the speed of the operation by using the options for Ignore same size and Ignore same timestamp. If these options are enabled, then if the file already exists on the destination, the file will be skipped if it has the same size or file timestamp, corresponding to each option. Note that in order for the timestamp feature to work reliably, both the source and destination filesystems should be the same. Otherwise existing files are always overwritten with the copies from the source.