HCL Workload Automation, Version 9.4

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 the -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 the -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 the -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 the -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 the -filename argument specifies a directory, the process waits until a file is deleted from the directory.
-deadline | -dea
The deadline period, expressed in seconds. Valid 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, see 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 than one file in the monitoring process, you can store the files in a 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.