Move task configuration

Edit online

Configure the following properties for the Move file operation task:

Describing configuration parameters for the 'Move' task in Managed File Transfer

Field Description
Task name Type a unique name for the task.
File filter Type the name of the file if you want to filter files with specific names. By default, Managed File Transfer considers all files. If you want to use regular expression, specify a valid regular expression in the File filter and select the Use regular expression option.
Note: Use wildcard characters to filter the file names. For example, type *.zip to trigger the action only when ZIP files are uploaded or downloaded. To trigger an action based on a name string in the ZIP files, use the name string in the File filter box, which is preceded and followed by wildcard characters. For example, type *invoice*.zip to trigger the action based on the file URLs, when ZIP files containing the character string invoice in their file names are uploaded or downloaded. If you define a File filter for a task, the task acts only on files that are filtered out.
The following are a few examples of regular expressions:
^(?!.*purchaseorder).*$
Excludes files with the file URL containing purchaseorder.
*/out/.*
Include files with the file URL containing the folder out.
^abc(.*)123$
Includes anything that starts with abc and ends with 123. Matches abc123, abcxyz123, but not abcxyz123def.
NEW-((*.doc)⏐(*_backup_*))
Includes anything that starts with NEW- that either ends in .doc, or is followed by the string _backup_.
Destination location Select one of the following options to configure the location where the file is copied to:
Remote path
If the destination location is on a remote server, select a protocol (transport mechanism) from the list, and type or browse to the file path location. For example, protocol://<host\>:<port\>/DestinationFolder/.
Virtual folder
To specify a virtual folder, type or browse to the location of the folder. If you want to point to a subfolder within the folder, append the URL in the box with the details of the subfolder.
Note: The virtual folder that you select must be configured on the same Managed File Transfer instance on which the action is configured.
  • Type the User name and Password for the remote system.
  • Click Test Connection to check the connection to the remote server.
    Tip: Do the following to connect to a remote server by using a secure protocol (FTPES, FTPS, HTTPS, or SFTP) and to and configure secure key exchange authentication:
    1. Create a folder for the remote server and configure the certificate alias parameters.
    2. Use the folder that you configured in the Virtual folder option of the Source location in the task.
Execute error task Select this checkbox to run an error task if the file operation fails.
Advanced
Preserve folder structure When copying or moving files, select the Preserve folder structure checkbox to retain the original folder structure. If not selected, all files including files in subfolders are placed directly in the destination folder, overwriting existing files with the same name. When the checkbox is selected, the folder structure from the source is replicated at the destination. When you select Preserve folder structure, the Create directory checkbox is selected automatically. If there's an Unzip task before the Copy or Move task, the unzipped files also retain their folder structure in the destination folder.
Note:
  • Child folders in the source will be deleted unless you select Exclude folder in the Find task.
  • Do not enable parallel processing. If parallel processing is used, the parent folder might be moved or deleted before its files are processed, which can cause the task to fail.
Create directory Select this checkbox to create the destination folder if the folder specified in Destination location is not present. If Destination location path does not include a folder, Managed File Transfer copies the file directly to the specified directory path. Ensure that the application has permission to create directories at the destination.
Check if the file exists at destination Select this checkbox to check whether the file exists at the destination location and run one of the following actions:
Skip the transfer if file exists
This option skips the file transfer if the file with the same file name exists at the destination. Further actions are not run on that file at the destination. For example, to run Move and Rename tasks on a file. The Move task skips that particular file if the file exists at the destination. In addition, the Rename task is not run on that particular file.
Fail the action if file exists
This option causes the action to fail if a file with the same file name exists at the destination location. In this case, the execution of the action stops and it is marked as a failure. During parallel execution, only the file that is already at the destination is not processed. The remaining files complete their processing and are transferred to the destination. For example,
  • For parallel execution, consider that you want to run Move and Rename tasks on multiple files. Assume one of the files is already at the destination. The Move and Rename tasks fail only for that file that exists at the destination. Managed File Transfer continues processing the remaining files for both Move and Rename tasks.
  • For nonparallel execution, consider that you want to run Move and Rename tasks on multiple files. Assume one of the files is already at the destination. The Move and Rename tasks fail only for that particular file that is at the destination. Managed File Transfer moves the remaining files but does not process the Rename task for these files. In addition, any subsequent tasks for these files are not run.
Note: If you rename a particular file using the Rename file to option, then the Fail the action if file exists option checks for the renamed file name at the destination. The renamed file is added to the destination only if it does not match the rest of the file name.
Use temporary file name Select this checkbox and specify a temporary file name to be used during the move file process. The file is renamed to its original name after the move file operation is complete.
Note: The temporary file name is not used for a file that is moved within an operating system or server.
Preserve file modification date Select this option to retain the timestamp that indicates when the file was last modified
Check for stability If you want the file operation to check its progress at regular intervals, specify the time in seconds in the following format: Every [ ] seconds up to [ ] seconds, where, [ ] is the text box to type the value in seconds.
Retry [ ] times at an interval of [ ] seconds Select this option to retry a failed move operation for the specified number of times at the interval specified in seconds.
Resume transfer from the point of interruption Select this option to resume an interrupted or failed move operation from the point of interruption.
Command before upload Choose this option to run a SITE command before the Move task. For example, when you work with Mainframe servers, you can send values for record size and block size to the server before upload by setting the following value for this configuration field:SITE LRECL=<record\_size\> BLKSIZE=<block\_size\>
Simple mode Select this option to change the file transfer mode to simple mode and if you are transferring files to AS/400 systems. This mode is applicable for FTP, FTPS, or FTPES protocols.
ASCII mode Select this option to change the file transfer mode to ASCII mode and choose one of the following Convert line endings options for Managed File Transfer to change the line endings of the file:
  • CRLF - Windows
  • CR - MAC OS Classic
  • LF - Unix
  • No change
This mode is applicable for FTP, FTPS, or FTPES protocols. By default, Managed File Transfer uses the Binary file transfer mode for the Move operation.
Assign partner Select this option to assign a partner for the action. Then do one of the following tasks:
  • Select the partner to assign from the list of configured partners in Managed File Transfer.
  • Type a parameterized value for the partner in the following format: [partner_name], where [partner_name] is a server variable or an action parameter that contains the actual partner name during the execution of an action.
Note: For virtual folders, use this option only if you want to override the partners configured for the folders.
A Move task moves all the files that are passed on from the previous task to the location specified in Destination location. The files are removed from the source folder. The list of files in the destination location is passed on to the subsequent task. For example, assume that there exists an action with the following configuration:
  • Find task Find files in Source location.
  • Encrypt task Encrypt the files.
  • Move task Moves the files to the Destination location.
The following operations take place when the action is run:
  • The Find task lists all the files in the Source location.
  • The Encrypt task encrypts all the files that the Find task lists.
  • The Move task moves the files that the Encrypt task encrypts, to the Destination location