ProcessFile

The ProcessFile command action is used to transfer a file that matches the defined selection criteria.

The CFInternet client communicates with the TIBCO MFT Internet Server defined by the Global.xml file. It extracts a list of all files that the user can transfer and compares it against the filters that are defined. If multiple filters are defined, both filters must match for the file to be displayed. This command causes the file that matches the filters to be transferred (either uploaded or downloaded). If one transfer is unsuccessful, TIBCO MFT Internet Server continues to the next transfer. The command terminates with one of the following return codes:

Code Meaning
0 All files transferred successfully.
3 No files selected for processing.
4 Partial success.
8 All files transferred unsuccessfully.

The following table lists parameters supported for this command action.

Parameter Description Default Required
ClientFileName Specifies the 1 to 256 byte client file name to be used as a filter.

The ClientFileName is compared against the ClientFileName of the TIBCO MFT Internet Server file definitions returned to CFInternet. If they match, then the file is compared against any other filters defined.

This field is case sensitive. The asterisk (*) may be used as a wildcard character.

For example: ClientFileName: NYACCT_Test_File

None No
Description Specifies the 1 to 256 byte description to be used as a filter.

The Description is compared against the description of the TIBCO MFT Internet Server file definitions returned to CFInternet. If they match, then the file is compared against any other filters defined.

This field is case sensitive. The asterisk (*) may be used as a wildcard character.

For example: Description: NYACCT_Test_File

None No
LocalFileName Specifies the 1 to 256 byte local file name.

This file name replaces the ClientFileName defined by the TIBCO MFT Internet Server file definition.

When a file is uploaded, this field defines the client source file name. For example, the file that is read and sent to the remote system.

When a file is downloaded, this field defines the client target file name. For example, the file that is written to the local system.

This field is case sensitive on some platforms such as UNIX.

For example: LocalFileName:/prod/cfcc/NY/file1.abc

None No
SubDir For directory uploads, if required, specifies TIBCO MFT Internet Server to scan subdirectories for files to transfer.

For directory downloads, if required, specifies TIBCO MFT Internet Server process data in TIBCO MFT Internet Server subdirectories.

When No is specified, TIBCO MFT Internet Server processes files only in the defined directory.

When Yes is defined, TIBCO MFT Internet Server processes files in SubDirectories as well as in the defined directory.

This parameter is valid only for TIBCO MFT Internet Server file definitions defined with the directory flag. It is ignored for all other requests.

This parameter is supported on all List and Process calls.

FileName This parameter is used only on directory download requests.

It allows the user to define a single server file name to download. It is allowed only on ListFile and ProcessFile calls. The asterisk (*) may be used as a wildcard character.

Sample ListFile Command

The sample command below shows how to transfer a file that matches the defined selection criteria.

java cfcc.CFInternet a:ProcessFile Description:Prod_ACCT_Y2005 ClientFileName:my.cfcc.file LocalFilename:/prod/cfcc/ny/file1.abc