Source—FTP Remote

Use the Source tab to configure a new source or edit an existing source. How? The tab content depends on the source type. Settings for sources of type FTP Remote are listed here.

The FTP Remote Source tab is arranged in the following sections:

General Information and Actions

Element	Description
Save	Saves the source without deploying it. Remember to save before closing this tab.
Deploy/Deployed	Deploys and activates the source. You must save the source before you can deploy it. You must re-save before you can redeploy. The configuration must be valid or deployment fails. The Deploy Source dialog appears, prompting you for an optional comment. Impacted transfers are listed. Click the Deploy or Cancel button in the dialog. The Deploy action in the tab is grayed with a green check to show successful deployment. To view information about deployed artifacts, click the Show Deployment Details button on the Artifacts Search tab, or view the Deployments tab on the Monitoring page.
Revert	Reverts all changes since the last save.
General Information	Click the arrow to the left to display read-only source information, including name, last user to update, last update date and time, and last deployment date and time.
Name	Name of the source.
Description	Allows you to add or edit the artifact description. This description is for all deployments of the artifact and is visible in the Artifacts Search tab. The Deploy dialog also allows you to enter a description, which is specific to a particular deployment label and is visible in the Deployments tab on the Monitoring page.

Location

Click the arrow to the left to display information about the location of files to be transferred.

Element	Description
Content Folder	Specifies the directory from which files are transferred.
Include Content in Subfolder	Specifies that files in subfolders are also transferred if checked.

Source Properties

Click the arrow to the left to display source properties.

Element	Description
User Name	Specifies the user as whom to access the source.
Password	Specifies the user password.
Confirm Password	Confirms the user password.
Host	Specifies the host name.
Control Port	Specifies the port for the source.
File Type	Specifies the file type: binary or ACSII.
Minimum Age	Specifies the minimum time in seconds of existence in the source location for files to be transferred.

Source Schedule

Click the arrow to the left to display information about when the source is checked for files to be transferred. Source schedule settings affect all transfers that use the source.

Element	Description
Polling
Polling Interval	Specifies the frequency in seconds at which the source is checked for files to be transferred. A source polling interval and a source schedule act independently unless Use Duration is checked in the schedule configuration. In that case, polling occurs within the specified duration.
Add schedule	Allows you to schedule transfers that use this source. For more information, see Scheduler.
Event	Specifies the Event check box, if enabled, allows you to execute transfers through a SOAP/REST service.
Security	Security enabled implies that protection is valid for Administrators and any other users selected.
Add Users, Groups, and Roles	Adds users, groups, and roles to the list of who can access transferred files. For more information, see Add Users, Groups, and Roles.

Actions

Source action apply to all transfer from this source. They are defined as a sequence of processing steps to execute in the MFT File Store. Processing steps are applied before content is sent to targets. Click the arrow to the left to display source processing actions, which affect all transfers that use the source.

Element	Description
Add processing actions	Allows you to compress, decompress, encrypt, or decrypt transferred files before the transfer. For more information, see Pre-Processing Actions.

Advanced Properties

The Advanced Properties section of the FTP Remote Source tab allows you change advanced source properties.

Element	Description
General	Click the General tab to display general advanced properties.
FTP Path Separator	Specifies the separator for file paths. The default is a forward slash (`/`).
List Parser Key	Specifies the key for parsing `ls` command results: `UNIX` (default), `Win MVS`, or `MVS`. When connecting to Windows FTP Server, change the List Parser Key to Windows, and configure the recent date and default date to `MM-dd-yyyy HH:mm` format.
Account Name	Specifies the account name to use if the User Name has more than one attached account.
Absolute Path Begin	Specifies the beginning of absolute file paths. The default is a forward slash (`/`).
Connection Mode	Choose whether you want MFT to use passive or active mode when it connects to the remote FTP server.
Data Port	Specifies the data port for an active connection if different from the command port. FTP uses two channels between client and server, which are separate TCP connections. The command channel is for commands and responses. The data channel is for transferring files.
Trigger File Strategy	Specifies when the Trigger File activates the transfer: End Point Activation, Every Time, or Once Only.
File Name	Specifies the file that activates the transfer when present. Note: If the Trigger File directory is same as Content Folder (input) directory, and there is an Include Files pattern, the Trigger File Name must not match the file inclusion pattern. If the Trigger File directory is same as Content Folder (input) directory, and there is an Exclude Files pattern, the Trigger File Name must match the file exclusion pattern. Else, this results in validation error causing source deployment failure. This is to prevent trigger files from being processed as content (input) files.
File Directory Override	If Trigger File Strategy is selected, this property specifies the directory in which the trigger file is searched.
Ignore Files Without Time Format	Ignores files without a time format in their timestamp if checked. Typically such files are not recent.
Use Nlst	If remote server does not support LIST command, select the Use Nlst checkbox which is for AS400, MAINFRAME FTP servers.
Change Directory	If selected, directs MFT to change directory before downloading files from the remote FTP server.
Recent Date Format	Specifies the format for recent dates. The default is `MMM d HH:mm`.
Default Date Format	Specifies the default format for non-recent dates. The default is `MMM d yyyy`.
Remote Server Time Zone	Specifies the time zone of the remote FTP server relative to UTC.
Remote Server Language	Select the language of the remote FTP server. Note that the locale language of the FTP server can be set differently than the locale language of the operating system. If this is the case, MFT must construct a locale based on the Remote Server Language, Remote Server Country, and Remote Server Variant settings.
Remote Server Country	Select the country of the remote FTP server. Note that the locale language of the FTP server can be set differently than the locale language of the operating system. If this is the case, MFT must construct a locale based on the Remote Server Language, Remote Server Country, and Remote Server Variant settings.
Remote Server Variant	Specifies a remote server variant. The variant is a vendor and browser-specific code. Note that the locale language of the FTP server can be set differently than the locale language of the operating system. If this is the case, MFT must construct a locale based on the Remote Server Language, Remote Server Country, and Remote Server Variant settings.
Remote Server Encoding	Specifies which character encoding the remote FTP server uses.
Retain Processed File Names	Specifies whether to retain the processed file names list.
Additional Commands	Any additional commands to describe the proprietary FTP commands to be sent to FTP server running on the MVS platform. For example, <ftpmapping xmlns="http://schemas.oracle.com/ftpadapter/mapping"> <store command="STOR" desc="STORE Command" argument="${default}" success="$ftp.code = 125" > <executecommandsbefore> <ftp-command desc="Change Record Length"command="SITE" argument="LRECL=70" success="$ftp.code >=200 and $ftp.code <= 300"/> <ftp-command desc="Change Block Size" command="SITE" argument="BLKSIZE=27930" success="$ftp.code >= 200 and $ftp.code <=300"/> </executecommandsbefore> </store> </ftpmapping>
Content	Click the Content tab to display advanced properties related to the source content.
Optional filtering of source content specified as	Specifies how the filter string is interpreted: Wildcard (the default) or Regular Expression. If you selected Wildcard, use `` as a wildcard. For example, `.xml` specifies that XML files are transferred. To specify text or XML files, you can use `*.(xml\|XML\|txt\|TXT)`. For example, File = "TXT-20100505-XXXX.txt" where XXXX can be any four successive digits. Regexp Filter expression = "XT-20100505-\\d{4}\\.txt" For more information about regular expressions, see The Java Tutorials: Regular Expressions.
Include Files	Includes files in the transfer. You can use * as a wildcard. For example, `*.xml` specifies that XML files are transferred. If Include Files is not specified, all files are included unless excluded by Exclude Files, which takes precedence. Transfers can specify files to include using filters. For more information, see Transfer. Exclude Files and Include Files are executed before transfer filters. Coordinate your sources and transfers accordingly.
Exclude Files	Excludes files from the transfer. You can use * as a wildcard. For example, `*.xml` specifies that XML files are not transferred. If Exclude Files is not specified, no files are excluded. Transfers can specify files to include using filters. For more information, see Transfer. Exclude Files and Include Files are executed before transfer filters. Coordinate your sources and transfers accordingly.
Proxy Settings	Click the Proxy Settings tab to display advanced properties related to proxy server configuration.
User Name	Specifies the user as whom to access the proxy server.
Password	Specifies the password for the proxy server user.
Port	Specifies the proxy server port.
Host Name	Specifies the proxy server host name.
Use Proxy	Uses the configured proxy server if checked.
Security	Click the Security tab to display advanced properties related to security.
Channel Mask	Specifies which channels should be encrypted: Both (default), Control, Data, or None. FTP uses two channels between client and server, which are separate TCP connections. The command channel is for commands and responses. The data channel is for transferring files.
Implicit SSL	Specifies that implicit SSL is used if checked.
SSL	Specifies that SSL is used if checked.
Enable CCC	Enables the `ccc` command if checked. The Clear Control Connection (CCC) setting causes the FTP server to revert to plain text after authentication.
Performance Attributes	Click the Performance Attributes tab to display advanced properties related to performance.
Thread Count	Specifies the number of threads the transfer uses. If set to `0`, acts as Single Threaded does. If set to `-1`, uses the global thread pool with a poll size of 4. The maximum allowed value is 40.
Single Threaded	Specifies that the transfer is single-threaded and deactivates Thread Count if checked. Only one thread polls for and transfers files.
Max Raise Size	Specifies the maximum number of files transferred per each Polling Interval cycle.
Operation	Click the Operation tab to display advanced properties related to file operations.
Action Type	Specifies the action taken after files from this source are transferred: None, Archive, Delete, or Archive and Delete.
Physical Target Directory	Specifies the directory to which to copy files if Archive is selected or move files if Archive and Delete is selected.