Advanced general parameters

The File name field in the After the completion of a successful file transfer the source file will be, After the completion of a successful file transfer the destination file will be and Create Empty File fields parameters can contain variables, constants, and the following variables:

EXAMPLE: If you want to rename a transferred file old_cmd_060101.exe, when it was originally named cmd.exe, the pattern you must specify is old_$$AFTFILE$$_%%DATE.

The following table lists the advanced general parameters.

Parameter

Description

Perform the following action on the source file, after a successful transfer

Determines how a source file is handled after a successful transfer:

  • Leave file as is: Retains the source file with the original name
  • Delete file: Deletes the source file
  • Rename file to: Renames the source file with a valid name for the operating system of the host computer (256 characters)
  • Move file to: Moves the file to a specified location (full path only) (Not available for MVS)
  • Change file permission to: Changes the UNIX permission level of the file, such as 755
  • Run command on file: Runs a specific command on the file on File System connection profile only

NOTE: (Windows only) The format must be as follows:

cmd /c <command>

If you are running a script a script or executable file you need one of the following:

  • The full path to the file.
  • The folder of the file must be in the PATH environment variable.
  • The file must be located in the <Agent>\cm\AFT folder.

    NOTE:If the action fails, Control-M for MFT attempts a retry according to the number of retries, as described in Control-M for MFT configuration parameters.

Fail transfer when action on source file failed

Determines whether to fail the transfer when a post action on the source file fails after a successful transfer.

If the file of the same name as the destination file already exists:

Determines what to do to a file that has the same name as the destination file:

  • Overwrite: Replaces the existing file with the transferred file
  • Append: Attach the transferred file to the existing file, as well as, transfer multiple files into one combined file, using a wildcard character
  • Abort: Cancels the file transfer
  • Skip: Skips the file
  • Add unique counter: Adds a numerical value to the filename
  • Add timestamp: Adds a timestamp to the filename

After the completion of a successful file transfer the destination file will be

Determines how a destination file is handled after a successful transfer:

  • Leave file as is: Retains the destination file with the original name
  • Rename file to: Renames the destination file with a valid name for the operating system of the host computer (256 characters).
  • Move file to: Moves the file to a specified location (full path only) (Not available for MVS)
  • Change file permission to: Changes the UNIX permission level of the file, such as 755
  • Run command on file: Runs a specific command on the file on File System connection profile only.
  • Add empty file: Adds an empty file in the destination to signal that the file transferred successfully.

NOTE: (Windows only) The format must be as follows:

cmd /c <command>

If you are running a script a script or executable file you need one of the following:

  • The full path to the file.
  • The folder of the file must be in the PATH environment variable.
  • The file must be located in the <Agent>\cm\AFT folder.

NOTE: To define the destination filename for each file that is transferred when the destination path is a directory, see Destination Filename parameters.

NOTE:If the action fails, Control-M for MFT attempts a retry according to the number of retries, as described in Control-M for MFT configuration parameters.

Fail transfer when action on destination file failed

Determines whether to fail the transfer when a post action on the destination file fails after a successful transfer.

Create empty file in destination

Creates an empty file after a transfer on the destination host.

If you are transferring a file or multiple files, the empty file is created in the directory where the file(s) are transferred.

If you are transferring a directory, the empty file is created in the directory where the transfer directory is created.

Add temporary prefix/suffix

Prevents overwriting files by attaching a temporary file prefix or suffix, such as FTP_ or .tmp to the destination file until the transfer completes successfully.

On OS/400 systems, the file name is limited to 10 characters. The temporary prefix can be up to 99 characters long on all other systems.

NOTE: On z/OS systems, the file name is limited to 8 characters.

The temporary file name that is created by applying the prefix or suffix must be a valid file name for the operating system of the destination host computer.

Continue on failure

Allows successive transfers to run when this specific transfer fails

Delete destination file on failure

Deletes the failed transferred file from the destination host.

If you transferred multiple files, the last file that failed is deleted.

Do post AFT command on failure

Activates the defined post commands when the job fails.

Recursive

Transfers a file directory with all its subdirectories and all files that match the wildcard pattern in the source file path field under all sub-directories.

Files are transferred in the destination with the same directory structure as the source directory structure.

Exclude Files

Determines whether to exclude all the files that match the transfer pattern when you define a transfer with a wildcard.

List directory to a file

Lists all the files and directories from either the source or destination hosts or both in the specified file. This option enables other processes to process this file automatically. For more information, see the List Directory option in Transfer options.

NOTE: If you do not define the full path, the file is saved in cm/AFT/.

Incremental Transfer (transfer files based on modified timestamp since the last successful job execution)

Determines whether to transfer files that were added or modified in the source directory since the last successful job execution. You might want to use this option in a cyclic job to transfer the changes from the source directory. You might want to use this option in a cyclic job to transfer the changes from the source directory.

NOTE:

  • This parameter is not available for Watch or Watch & Transfer options.
  • UNIX/Linux only
  • To synchronize sub-directories, use the Recursive option.
  • You can use file pattern in the source path to transfer specific files. For example: /src_path/*.pdf
  • If the FTP server is in a different time zone than the Control-M/Agent, you need to add the ftp.timezone.offset additional parameter in the connection profile with the relevant timezone of the FTP server host, as described in .Connection profile manual additional parameters.

Transfer files based on on modified timestamp in the last __ hours on the first job execution

Determines whether to transfer files that were modified in the specified interval or to transfer all files that match the pattern on the first job execution.

Parent Topic

Advanced options