Creating an MFT Enterprise Post Processing Rule
This procedure describes how to create an MFT Enterprise post processing rule. After an external user uploads a file, the Hub receives it and processes the file based on defined rules such as moving the file to another location and sending alert email messages.
Run anti-virus for each arriving file and delete it if the scan fails. Order a job that transfers an arriving file from the Hub to a specific server. Copy all files that appear in Folder1/incoming to backup directory on the network.
Before You Begin
Ensure that you have completed all the setup procedures, as described in Setting up the Control-M MFT Enterprise Environment.
Begin
-
From the Managed File Transfer domain, select MFT Enterprise Configuration.
If the button is disabled, you need to install Control-M MFT B2B, as described in Control-M MFT Enterprise Installation.
-
Log in with the same username and password that you used to log in to Control-M Web.
The MFT B2B window appears.
-
Select the Rules tab, and then click .
-
Do the following:
-
In the Name field, type the name of the rule.
-
In the Description field, describe the purpose the rule.
-
From the Priority drop-down list, select the priority level for this rule.
-
If you select a higher priority level, this rule will be processed before other matching rules. 1-Highest, 10-Lowest.
-
-
Click the Conditions tab, select one or more of the following conditions for this rule and then click Add.
-
If file name matches a pattern
-
If file matches a certain size
-
If file sent by specific user/company
-
If arrives in specific virtual folder
To create a rule that executes for every incoming file, leave the conditions section empty.
-
-
Apply the condition criteria, as described in Control-M MFT Enterprise Rule Conditions.
-
Click the Actions tab, select one or more of the following actions for this rule and then click Add.
-
Notify by email
-
Move/Copy received file
-
Order Control-M folder/job
-
Raise Control-M condition
-
Run command/script
To ensure that jobs that are ordered close to New Day time are executed, set Max Wait to at least 1 for Order Control-M folder/job.
-
-
Apply the action criteria, as described in Control-M MFT Enterprise Rule Actions.
-
Click Save.
Control-M MFT Enterprise Rule Conditions
The following table describes the Control-M MFT Enterprise conditions that you can apply for each rule.
Parameter |
Description |
---|---|
If file name matches a pattern |
Determines whether the file matches a specific filename, a regular expression, or if it is case sensitive AAA.txt,B*.pdf,C???.csv |
If file matches a certain size |
Determines the minimum and maximum file size in bytes, KB, MB, or GB |
If file sent by specific user/company |
Determines which users or companies sent the file |
If file arrives in specific virtual folder |
Determines which virtual folders external users can upload files to. |
Control-M MFT Enterprise Rule Actions
The following table describes the Control-M MFT Enterprise actions that you can apply for each rule.
You can also use variables for each parameter, as described in Action Rule Variables.
Parameter |
Description |
---|---|
Notify by email |
Defines the email address, subject, and message of the notification. It also determines whether to abort, delete the file, or continue to the next action if the action fails. |
Move/Copy received file |
Determines whether to move or copy the file the file to a relative or absolute path and whether to rename the destination file. It also determines whether to abort, delete the file, or continue to the next action if the action fails. |
Order Control-M folder/job |
Determines which folder and jobs to run with run options and variables. It also determines whether to abort, delete the file, or continue to the next action if the action fails. |
Raise Control-M condition |
Determines the Control-M condition name and condition date to raise. It also determines whether to abort, delete the file, or continue to the next action if the action fails. |
Run command script |
Defines the executable command or script to run with successful return codes..It also determines whether to abort, delete the file, or continue to the next action if the action fails. Do not change the file name (by renaming or moving) if one of the other matching rules is expected to use this file. |
Action Rule Variables
The following table describes the variables that you can use as values for actions in a rule.
Variable |
Description |
---|---|
$$FILE_PATH$$ |
Defines the path of the file. \b2bhome\Folder1\incoming\aaa.txt |
$$FILE_ABS_PATH$$ |
Defines the absolute path of the file. C:\Agent\cm\AFT\ftshome\b2bhome\Folder1\incoming\aaa.txt |
$$FILE_DIR$$ |
Defines the parent directory of the file. \b2bhome\Folder1\incoming |
$$FILE_ABS_DIR$$ |
Defines the absolute parent directory path of the file. C:\Agent\cm\AFT\ftshome\b2bhome\Folder1\incoming |
$$FILE_NAME$$ |
Defines the name of the file. aaa.txt |
$$FILE_NAME_NO_EXT$$ |
Defines the name of the file without an extension |
$$FILE_EXT$$ |
Determines the file extension (including the "." character). |
$$FILE_EXT_NO_DOT$$ |
Determines the file extension (without the "." character). |
$$FILE_DATE$$ |
Defines the date of the file in YYYYMMDD format in UTC time. 20180325 |
$$FILE_TIME$$ |
Defines the time of the file in HHmmSS format in UTC time. 170459 |
$$FILE_SIZE$$ |
Determines the size of the file in bytes |
$$USER$$ |
Determines which users uploaded the file. |
$$COMPANY$$ |
Determines which company uploaded the file. |
$$VIRTUAL_FOLDER$$ |
Defines the virtual folder name |
$$EMAIL$$ |
Defines the user email address. |
$$PHONE_NUMBER$$ |
Defines the user phone number. 704123456 |
$$SUB_DIR_PATH$$ |
Defines the destination sub-directory path of the file. Sub1/Sub2 |