File Watcher parameters

Control-M for MFT enables you to watch a file until it reaches a certain size or has reached a maximum time limit. After the criteria is met, the file watch is complete, the file is transferred or continues to the next file transfer definition in the job.

To watch or watch and transfer files, see Defining a File Transfer job. To configure additional File Watcher parameter, see Configuring Control-M for MFT parameters.

The following table describes the parameters for a File Watcher job:

Parameter

Description

Maximum time to wait

Determines the number of hours, minutes, or seconds to wait, in the Time Limit field, for a file to reach its minimum detected size and remains static, according to the values defined in the Configuration Management window, as described in Configuring Control-M for MFT parameters.

If the value is 0, the file waits indefinitely.

Wait until specific time

Determines the specific time, in the Time Limit field, that a file has to reach its minimum detected size and remains static, according to the values defined in the Configuration Management window, as described in Configuring Control-M for MFT parameters, before the watch fails

Minimum detected size

Defines the minimum number of bytes transferred before Control-M for MFT checks if the file is static.

File size information for remote file systems is not supported.

This feature is not supported on OS400, Tandem, MVS, and OS2200 when the connection type is FTP.

Maximum file age

Defines the maximum number of years, hours, and/or days that can pass since the watched file was last modified.

For example, 2y3d means that after 2 years and 3 days have passed the file will no longer be watched.

Minimum file age

Defines the minimum number of years, hours, and/or days that must pass since the watched file was last modified.

For example, 2y3d means that after 2 years and 3 days must pass before the file can be watched.

Override default interval between file searches

Determines whether to override the value of the Interval between file searches field in Configuration dialog box in the CCM.

If age and size criteria are not met, continue searching matching files

Determines whether to continue searching the remaining files if the first file that matches the name pattern doesn't match the size and age criteria.

Transfer all matching the name pattern

Determines whether to transfer all remaining static files that match the name pattern (regardless of the size and age) after a single file matches all criteria.

Transfer files only if they match size and age criteria

Determines whether to transfer all remaining static files that match the name, size, and age criteria after a single file matches all criteria

Variable containing detected file name

Defines the variable name that contains the detected file name

Variable type

Determines whether the variable is one of the following:

  • Global: Enables you to use the variable in other jobs that are utilized by the same Control-M/Server.
  • Local: Enables you to use the variable in this job only.

    NOTE: The Maximum file age and Minimum file age features are supported if the user defined for the watch host has write permissions on the destination path.

    NOTE: In the job log, if the OSCOMPSTAT parameter is 7 it indicates that file watch failed.

Parent Topic

Advanced options