File Trigger Information
You can register the File Trigger Information. There are two ways to register the information.
-
Registration using the HULFT Management Console
=> Refer to Using the File Trigger Information
-
Registration by running commands with parameter files
=> Refer to Management Information Batch Registration command
You can use the File Trigger Information database only if HULFT10 Enterprise grade is installed.
Field List
In the table below, the check marks in the Optional column indicate the fields considered optional during registration from the HULFT Management Console. Optional fields and mandatory fields for registration by running commands with parameter files may differ from those for registration using the HULFT Management Console.
For details on optional fields and mandatory fields for registration by running commands with parameter files, refer to Management Information Batch Registration command.
Field Value |
Default Value |
Setting Value |
Optional |
Remarks |
|
---|---|---|---|---|---|
Screen |
File |
||||
TRGID |
|
Uppercase alphanumeric characters and "_" |
- |
Within 50 bytes |
|
COMMENT |
|
Characters |
✓ |
Within 60 bytes |
|
DIRECTORYNAME |
|
Characters |
- |
Within 200 bytes (*1) |
|
TARGETFILENAME |
|
Alphanumeric characters |
- |
Within 200 bytes (*1) |
|
JOBID |
|
Alphanumeric characters and "_" |
- |
Within 50 bytes |
|
SUBDIRECTORY |
N |
Y, N |
✓ |
|
|
REGEX |
N |
Y, N |
✓ |
|
|
CREATE |
Y |
Y, N |
✓ |
|
|
DELETE |
Y |
Y, N |
✓ |
|
|
MODIFY |
Y |
Y, N |
✓ |
|
|
TYPE |
T |
T, S |
✓ |
|
|
FILECHECK |
Y |
Y, N |
✓ |
|
|
FILECHECKWAIT |
Y |
Y, N |
✓ |
|
|
INTERVAL |
10 |
10–2678400 |
- |
Unit: seconds |
|
EXECUTION |
Y |
Y, N |
✓ |
|
✓ |
: |
Optional |
- |
: |
Mandatory |
*1 |
: |
The total length of the strings that you specify for Path to Directory (DIRECTORYNAME) and File Name (TARGETFILENAME) must be within 200 bytes. |
Explanation of each field
This section explains the fields to be specified in the File Trigger Information. The parenthesized strings are the names of each field and you can use them as field tags in a parameter file when registering the information.
- Trigger ID (TRGID)
-
ID that identifies the file to be monitored
- Comment (COMMENT)
-
Comment for the File Trigger Information
- Path to Directory (DIRECTORYNAME)
-
Directory that contains the file to be monitored
Specify this field with a full path.
You cannot use a regular expression or a wild card for this field.
- File Name (TARGETFILENAME)
-
Name of the file to be monitored
Use a regular expression or a wild card to monitor multiple files at the same time.
When you use a wild card, you must specify 'N' (Do not use a regular expression) for Use Regular Expression (REGEX).
- Job ID (JOBID)
-
ID of the job to be started when HULFT detects creation, deletion, or modification of a file
- Monitor Subdirectories (SUBDIRECTORY)
-
Monitoring of subdirectories
Specify whether to monitor subdirectories.
- Y:
-
Monitor subdirectories
- N:
-
Do not monitor subdirectories
Omitting this field sets 'N' (Do not monitor subdirectories).
- Use Regular Expression (REGEX)
-
Use of a regular expression to specify the file name
Specify whether to use a regular expression to specify the file name.
- Y:
-
Use a regular expression
- N:
-
Do not use a regular expression
Omitting this field sets 'N' (Do not use a regular expression).
- Monitor Creation (CREATE)
-
Monitoring for the creation of a new file
Specify whether to monitor for the creation of a new file.
- Y:
-
Yes
- N:
-
No
Omitting this field sets 'Y' (Yes).
- Monitor Deletion (DELETE)
-
Monitoring for the deletion of a file
Specify whether to monitor for the deletion of a file.
- Y:
-
Yes
- N:
-
No
Omitting this field sets 'Y' (Yes).
- Monitor Modification (MODIFY)
-
Monitoring for the modification of a file
Specify whether to monitor for the modification of a file.
- Y:
-
Yes
- N:
-
No
Omitting this field sets 'Y' (Yes).
- Monitoring Method (TYPE)
-
Definition when monitoring for modification
Specify how HULFT determines that the file was modified.
- T:
-
Determine whether the file has been modified based on the time stamp
- S:
-
Determine whether the file has been modified based on the file size
Omitting this field sets 'T' (Determine the modification of a file by referring to the time stamp).
- Check File Occupancy (FILECHECK)
-
Checking file occupancy
Specify whether to check if the file has been used by any other processes or applications.
- Y:
-
Yes
- N:
-
No
Omitting this field sets 'Y' (Yes).
When you specify 'N' (No), you must specify 'N' (No) for Wait File Availability (FILECHECKWAIT).
- Wait File Availability (FILECHECKWAIT)
-
Behavior of HULFT when the checking file occupancy fails
Specify whether to have HULFT wait until the application can confirm the availability or to have the attempt end at the time when the application fails in checking file occupancy.
- Y:
-
Wait
- N:
-
Do not wait
You can specify either 'Y' (Yes) or 'N' (No) for this field when you specify 'Y' (Yes) for Check File Occupancy (FILECHECK).
Specify 'N' (No) for this field when you specify 'N' (No) for Check File Occupancy. If you specify 'Y' (Yes) for this field, an error occurs.
When you omit this field, this field is set to 'Yes' (Y) if you specify 'Yes' (Y) and 'No' (N) if you specify 'No' (N) for Check File Occupancy, respectively.
- Check Interval (INTERVAL)
-
Interval for checking files
Specify the interval for checking files in seconds.
- Activate Monitoring (EXECUTION)
-
Activation status of the registered trigger ID
Specify whether to make the registered trigger ID a target for monitoring.
- Y:
-
Yes
- N:
-
No
Omitting this field sets 'Y' (Yes).
Points to be noted when setting
How to make specified monitoring conditions effective
Mere creation, deletion, or modification of the File Trigger Information does not enable the change of the monitoring conditions.
To enable the change of the File Trigger Information, it is necessary to restart the Observe daemon or to execute the File Trigger Information Control command.
File Name
-
You can monitor more than one file at the same time by using either of the following options:
-
Regular expression
When you use a regular expression for the file name, specify 'Y' (Use a regular expression) for Use Regular Expression.
-
Wild card
When you use a wild card for the file name, specify 'N' (Do not use a regular expression) for Use Regular Expression.
You can use a wild card as shown below.
Example:
When you want to monitor all files with an extension of txt in the directory that you specify for Path to Directory, specify '*.txt' for File Name.
-
-
If the total length of the directory name and the file name that you specify for Path to Directory and File Name exceeds 200 bytes, the file is not monitored. When you use a regular expression or use an asterisk (*) for a wild card, pay attention to the total length of the directory name and the file name.