Property | UI Field Name | Description | Specifications | Required |
|---|
| By Percentage | If fmtype = Changed (3); Amount that the file size has changed, expressed as a percentage of the original file size. For example, enter 10 to monitor for a change in file size of 10 percent (larger or smaller). | BigDecimal. | N |
| By Scale | If fmtype = Changed (3); Used in conjunction with bySize, specifies a change in file size that you want to monitor for. For example, to monitor for a change in file size of 10MB, enter 10 in bySize and enter 1024000 in byScale. | Integer; Valid values: - 1 = Bytes
- 1024 = KB
- 1024000 = MB
| N |
| By Size | If fmtype = Changed (3); Used in conjunction with byScale, specifies an actual change in file size. For example, to monitor for a change in file size of 10MB, enter 10 in bySize and enter 1024000 in byScale. | BigDecimal. | N |
| Monitor File(s) | Location and name of a specific file or file pattern (for example, ACT001*) being monitored. | Variables and Wildcards are supported. | Y |
| File Owner | If fmtype = Create (1), Delete (2), Changed (3), or Exist (4); User name / group name of the owner of the file on the operating system; that is, the user name / group name returned by the operating system in the file ownership information. | LDAP groups are supported. Specifying a file owner limits the search to files with that owner. | N |
| Monitor Type | Type of file event being monitored for. | Valid values: - As String = Created, As Value = 1
- As String = Deleted, As Value = 2
- As String = Changed, As Value = 3
- As String = Exist, As Value = 4
- As String = Missing, As Value = 5
Default is Created (1). | N |
| Maximum Files | If fmtype = Create (1), Delete (2), or Changed (3); For searches that use wildcards, limits the number of files to be searched. | Integer | N |
| Minimum File Scale | If fmtype = Create (1); Scale for the minimum file size. | Valid values: - As String = Bytes, As Value = 0
- As String = KB, As Value = 1
- As String = MB, As Value = 2
Default is KB (1). | N |
| Minimum File Size | If fmtype = Create (1); Minimum file size. |
| N |
| Recursive | Specification for whether or not the Agent File Monitor searches the specified directory and all sub-directories. | Boolean; Valid values: true/false. Default is false. | N |
| Scan Forward | If fmtype = Changed (3); Specification that once the Agent File Monitor has been satisfied, it should continue from where it left off. If it is scanning within a file, it should resume from the point in the file that it last scanned. If it is monitoring for files, it should resume monitoring for the next file. If you are scanning a file that is being overwritten each time and you want to start from the beginning each time, do not use scanForward. | Boolean; Valid values: true/false. Default is false. | N |
| Scan Text | If fmtype = Create (1), Changed (3), or Exist (4); String that the Agent File Monitor will search for in the file or files. Specifying a string means that only files containing the string constitute a match. |
| N |
| Stable (seconds) | If fmtype = Create (1) or Changed (3); Period of time, in seconds, during which the file has not changed (Agent File Monitor checks the modification timestamp and the file size). | Integer. | N |
| To Scale | If fmtype = Changed (3); Used in conjunction with toSize, specifies an actual file size that you want to monitor for. For example, to monitor for a file size of 5KB, enter 5 in toSize and enter 1024 in toScale. | Integer; Valid values: - 1 = Bytes
- 1024 = KB
- 1024000 = MB
Default is 1024. | N |
| To Size | If fmtype = Changed (3); Used in conjunction with toScale, specifies an actual file size that you want to monitor for. For example, to monitor for a file size of 5KB, enter 5 in toSize and enter 1024 in toScale. | BigDecimal; Default is 1024. | N |
triggerOnCreate
| Trigger On Create | If fmtype = Change (3); task is triggered if the file being monitored is being created.
| Boolean; Valid values: true/false. Default is false. | N |
| Trigger on Existence | If fmtype = Create (1); task is triggered if the file being monitored for creation already exists. | Boolean; Valid values: true/false. Default is false. | N |
| Use Regular Expression | Enables the use of a regular expression in fileName. | Boolean; Valid values: true/false. Default is false. | N |