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.

Begin

  1. 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.

  2. Log in with the same username and password that you used to log in to Control-M Web.

    The MFT B2B window appears.

  3. Select the Rules tab, and then click .

  4. Do the following:

    1. In the Name field, type the name of the rule.

    2. In the Description field, describe the purpose the rule.

    3. From the Priority drop-down list, select the priority level for this rule.

    4. If you select a higher priority level, this rule will be processed before other matching rules. 1-Highest, 10-Lowest.

  5. 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.

  6. Apply the condition criteria, as described in Control-M MFT Enterprise Rule Conditions.

  7. 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.

  8. Apply the action criteria, as described in Control-M MFT Enterprise Rule Actions.

  9. 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.

20180325

$$FILE_TIME$$

Defines the time of the file in HHmmSS format.

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.

user1@company1.com

$$PHONE_NUMBER$$

Defines the user phone number.

704123456

$$SUB_DIR_PATH$$

Defines the destination sub-directory path of the file.

Sub1/Sub2