Maintaining the filewatch log database
The log database is used to store filewatch activity
data. This log is located in the TWA_home/TWS
directory.
The default name is filewatchdb
.
When processing a file, filewatch uses it to store records
with information about:
- File name.
- File status. The allowed values are Exist, Created, Running, Completed, RunningCompleted, or Deleted.
- Date and time of file creation at the entry update time.
- Date and time of the last file modification at the entry update time.
- Date and time of the last entry update.
Note: The log contains only one entry for each file.
To maintain the log database, use the filewatchdb utility.
Syntax
filewatchdb -v | -u | -?
filewatchdb -c[ondition] condval
[-f[ilename] file_path
[-dat[abase] log_extension]
The arguments are not positional.
Arguments
- -v
- Returns the command version and exits.
- -u
- Returns command usage information and exits.
- -?
- Same as -u
- -condition
- The condition to be checked. Valid values are:
- bld| build
- Rebuild the log database.
- dlt | delete
- Delete the log database record corresponding to the filename argument value.
- gls | getLastStatusChange
-
Gets and returns the log database record corresponding to the filename argument value.
- -filename
- Use this argument to delete the entry corresponding to the specified value. You can embed blank or special characters, by using double quotation marks. Use * as wildcard character. This argument is required if you specify dlt (delete) or gls (getLastStatusChange) as condition value.
- -database
- Optional extension of the log database to be accessed. If you specify this value,
filewatchdb accesses the
TWA_home/TWS/filewatchdb.log_extension
database, otherwiseTWA_home/TWS/filewatchdb
is accessed.