Control File Collection Strategy
This section includes a description of the complementary Control File collection strategy that is applied for the Disk, FTP, SFTP, and SCP Collection agents. The Control File collection strategy enables collection of file(s) for which a corresponding control file exists. If the control file does not exist, the file is ignored.
Configuration
The Control File Collection Strategy controls which further configuration options that are available in the Source tab. If no strategy is selected, the default strategy is used.
Collection Strategy - Control File
Note!
The Collection Strategy drop down list will only be visible if there are other collection strategies available in the system, apart from the default collection strategy available.
Setting | Description |
---|---|
Collection Strategy | Select the Control File option in this list. |
Directory | Enter the absolute path name of the source directory on the remote host, where the source files reside. The path name may also be entered relative to the home directory of the User Name account. |
Include Subfolders | Select this checkbox to also include subfolders within the specified directory. |
Filename | Enter the name of the source files on the remote host. Regular expressions according to Java syntax can be used. For further information, see http://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html. ExampleTo match all file names beginning with |
Compression | Select compression type for the source files. This selection determines if the agent will decompress the files before passing them on in the workflow.
|
Position | The control filename consists of an extension added either before or after the shared filename part. Select one of the choices: Prefix or Suffix. Prefix means that the text entered inte the Control File Extension field will be searched for before the shared filename part, and Suffix means that the text entered in the Control File Extension field, will be searched for after the shared filename part. |
Control File Extension | The Control File Extension is used to define when the data file should be collected. A data file with filename The text entered in this field is the expected extension of the shared filename. The Control File Extension will be attached to the beginning or the end of the shared filename, depending on the selection made in the Position list, above. |
Data File Extension | The Data File Extension will only be applicable if Position  is set to Suffix. There can be cases where a more strict definition of which files should be collected is needed. This is defined in the Data File Extension field. Consider a data file called Note!Consider a directory containing 5 files:
After collection, the control file is handled in the same way as the collected file is configured to be handled, that is the system should delete/rename/move/ignore it. |
Move to Temporary Directory | If this option is selected, the source files will be moved to the automatically created subdirectory |
Inactive Source Warning (h) | If this option is selected, a warning message (event) will appear in the System Log and Event Area when the configured number of hours have passed without any file being available for collection: The source has been idle for more than <n> hours, the last inserted file is <file>. |
Move to | If this option is selected, the source files will be moved from the source directory (or from the directory |
Rename | If this option is selected, the source files will be renamed after the collection, and remain (or moved back from the directory |
Remove | If this option is selected, the source files will be removed from the source directory (or from the directory |
Ignore | If this option is selected, the source files will remain in the source directory after the collection. This field is not available if Move to Temporary Directory is enabled. |
Destination | If the Move to option has been selected, enter the full path name of the directory on the remote host into which the source files will be moved after the collection in this field. If any of the other After Collection options have been selected, this option will not be available. |
Prefix and Suffix | If any of the Move to  or Rename  options have been selected, enter the prefix and/or suffix that will be appended to the beginning and/or end of the name of the source files, respectively, after the collection, in these fields. If any of the other After Collection options have been selected, this option will not be available. |
Keep (days) | If any of the Move to  or Rename  options have been selected, enter the number of days to keep moved or renamed source files on the remote host after the collection in this field. In order to delete the source files, the workflow has to be executed (scheduled or manually) again, after the configured number of days. If any of the other After Collection options have been selected, this option will not be available. |
Route FileReferenceUDR | Select this checkbox to route File Reference UDR instead of raw data. |