HCL Workload Automation, Version 9.4

Parameters

COND
The condition to be checked. This is an required parameter. Valid values are:
wcr
Waits until the object exists. If the object already exists, FILEWATCH exits immediately.
wmr
Waits until the object size or modification time changes. If the object does not exists, FILEWATCH exits immediately.
wmc
Checks that the object size or modification time stopped changing, meaning that FILEWATCH waits for three search intervals without any change. If the object does not exists, FILEWATCH exits immediately.
wmrc
Waits until the object 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 object does not exists, FILEWATCH exits immediately.
wdl
Stops running when the object is deleted. If the object does not exists, FILEWATCH exits immediately.
FILE
The IBM i object to be processed. This is an required parameter. Use the following syntax depending on the type of object:
Native IBM i objects
  • Libraries: QSYS.LIB/library_name.LIB
  • Files: QSYS.LIB/library_name.LIB/file_name.FILE
  • File members: QSYS.LIB/library_name.LIB/file_name.FILE/member_name.MBR
where:
  • QSYS is the file system that supports the IBM i server library structure.
  • library_name is the name of an IBM i library.
  • file_name is the name of an IBM i file.
  • member_name is the name of an IBM i file member.

All the above syntax elements are not case sensitive.

Stream files (UNIX-like files)
Use the following syntax:
path_name/file_name
where:
  • path_name is the complete path of a UNIX directory.
  • file_name is the name of a UNIX file.

The above syntax elements are case sensitive.

DEADLINE
The deadline period, expressed in seconds. This is an required parameter. Specify an integer in the range 30 to 31536000.
INTERVAL
The object search interval, expressed in seconds. This is an optional parameter. Specify an integer in the range 5 to 3600 that is not greater than the value specified for the DEADLINE parameter. The default is 30.
RETCODE
The exit return code, if the condition is not successfully checked by the deadline. This is an optional parameter. Specify an integer in the range 11 to 256. The default is 20.