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:
The value is truncated to XXXX and used as such.-WARNING: value XXXXXXX for keyword '-database' is too long.
- -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.
- -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.
You find the trace output in the log of the job that run filewatch.