Arguments

-condition | -c
The condition to be checked. Valid values are:
wcr | waitCreated
Waits until the file exists. If the file already exists, filewatch exits immediately. If -filename argument specifies a directory, the process waits until the directory exists and contains a new file.
wmr | waitModificationRunning
Waits until the file size or modification time changes. If -filename argument specifies a directory, the process waits until the size or earlier file modification time changes, when a file is created, modified, or deleted.
wmc | waitModificationCompleted
Checks that the file size or modification time stopped changing, meaning that filewatch waits for three search intervals without any change. If -filename argument specifies a directory, the process checks the size or the earlier file modification time change, for example if the number of directory files and the earlier file modification time does not change within three search intervals.
wmrc | waitModificationRunningCompleted
Waits until the file size or modification time changes and stops changing, meaning that, after the first change, filewatch waits for three search intervals without any further change. If -filename argument specifies a directory, the process checks the size or the earlier file modification time change, for example if the number of directory files and the earlier file modification time does not change within three search intervals.
wdl | waitDelete
Stops running when the file is deleted. If -filename argument specifies a directory, the process waits until a file is deleted from the directory.
-database | -dat
Applies only to HCL Workload Automation Agents or to fault-tolerant agents in end-to-end configurations. It is a file extension to be added to filename filwatchdb, where the utility saves its file monitoring data. This provides the possibility to have more than one file watch database files.
The extension cannot be longer than 4 characters. If you specify a longer value, the following message is issued:
-WARNING: value XXXXXXX for keyword '-database' is too long.
The value is truncated to XXXX and used as such.
-deadline | -dea
The deadline period, expressed in seconds. The allowed formats are:
  • An integer in the range 0 to 31536000 (the upper value corresponds to one year). To have filewatch performing an indefinite loop, specify 0.
  • hh:mm:ss, in the range 00:00:01 to 24:00:00, to select a time within the same day when filewatch started.

    It corresponds to the GMT value. To specify a value different from the GMT, use the ENVAR parameter as shown in Example. For details about setting the TZ environment variable, refer to the UNIX System Services Command Reference.

-filename | -fi
The file path to be processed. You can embed blank or special characters, by using double quotation marks. Wildcard characters are not supported. To include more files in the monitoring process, you can store those files in a specific directory and use a file path specifying that directory.
-interval | -i
The file search interval, expressed in seconds. Specify an integer in the range:
  • 5–3600 when specifying wcr or wdl as condition value.
  • 30–3600 otherwise.
The default is 60.
-returncode | -rc
The exit return code, if the file is not found by the deadline. Specify an integer in the range 0 to 255. The returncode value is ignored if you specify 0 as deadline value. The default is 4.
-trace | -t
Trace level for internal logging and traces. Possible values are:
0
To receive error messages only.
1
Indicates the fine level, to receive the most important messages with the lowest volume.
2
Indicates the finer level, to activate entry and exit traces.
3
Indicates the finest level, to receive the most detailed tracing output.
The default value is 0.

You find the trace output in the log of the job that run filewatch.