File Trigger Information

This topic explains how to register the File Trigger Information.

You can view and modify this information on the following screens:

  • Register File Trigger Information/Modify File Trigger Information Record screen
  • Collecting and Distributing System Management Information screen

You can also import and export this information on the following screen:

  • Collecting and Distributing System Management Information screen
[Note]  
You can use this function if you have installed HULFT8 for Windows-Server.
For versions lower than HULFT-HUB Server Ver.3.9, if the client is HULFT Ver.8.4 or higher and the Forced Strong Key Mode is set to 'Enabled' in the System Environment Settings, connection with the client is not supported. Therefore, it is not possible to view, update, or newly register the management information for that client.

List of Fields

1. File Trigger Information

<Table> List of Fields for File Trigger Information

No. Field Name Default Value Setting Value Specification Remarks Update Distribute
A1 Trigger ID   Uppercase alphanumeric characters Mandatory Within 50 bytes
A2 Path to Directory   Alphanumeric characters Mandatory Within 200 bytes (*3, *4)
A3 File Name   Alphanumeric characters Mandatory Within 200 bytes (*4)
A4 Job ID   Alphanumeric characters Mandatory Within 50 bytes
A5 Monitor Subdirectories No *1 Mandatory *3
A6 Use Regular Expression No *1 Mandatory *3
A7 Monitor Creation Yes *1 Mandatory  
A8 Monitor Deletion Yes *1 Mandatory  
A9 Monitor Modification Yes *1 Mandatory  
A10 Monitoring Method Time Stamp *1 Mandatory  
A11 Check File Occupancy Yes *1 Mandatory  
A12 Wait File Availability Yes *1 Mandatory  

A13

Monitoring Interval 10 From 10 to 2678400 Mandatory Unit: second
A14 Activate Monitoring Yes *1 Mandatory  
A15 User Name   Alphanumeric characters Optional Within 20 alphanumeric characters (*2)
A16 Domain Name   Alphanumeric characters Optional Within 64 bytes
A17 Password   Alphanumeric characters Optional Within 127 bytes
A18 Comment   Alphanumeric characters Optional Within 60 bytes
*1: When you configure settings on the screen, select an option from the list that is shown on the screen.
*2: Both full-width and half-width characters are counted as a single character.
*3: Can be specified when the client is Ver.8.1 or higher.
*4: If the client is lower than Ver.8.1, the specification for the File Name must be within 200 bytes.
  If the client is Ver.8.1 or higher, the total combined length of the specification for the Path to Directory and for the File Name must be within 200 bytes.

2. Additional information other than File Trigger Information

You can view both the File Trigger Information and the following additional information on each screen where you edit the File Trigger Information.

 

<Table> List of Fields for Additional Information other than File Trigger Information

No. Field Name Default Value Setting Value Specification Remarks

Update

Distribute
B1 Alias   Alphanumeric characters Optional Within 256 bytes
B2 Business Group ID   *1 Mandatory  
B3 Batch Distribution ID   Alphanumeric characters *2   -
*1: When you configure settings on the screen, select an option from the list that is shown on the screen.
*2: You are allowed only to view this field on the screen.
[Legend]  
Default Value Value that is set for the field when you create a new management information record on a screen
Specification Whether the specification is mandatory or optional when you update the management information record on a screen
Update Register File Trigger Information/Modify File Trigger Information Record screen
Distribute Collecting and Distributing System Management Information screen
Availability of the field

Explanation of Each Field

The following describes the fields that are configured in the File Trigger Information.

For a field for which you select an option from the list, the following shows both the options that are displayed on the screen and the values that are described in the CSV file to be used for Collecting and Distributing System Management Information.

1. File Trigger Information

(A1) Trigger ID

This field specifies the ID to identify the file to be monitored.

(A2) Path to Directory

This field specifies the folder for the file to be monitored.

You cannot use a regular expression or a wild card for this field.

(A3) File Name

This field specifies the file to be monitored.

When the client is lower than Ver.8.1

Specify the absolute path.

You can use a wild card (*) in the file name. If you use an asterisk, you can monitor multiple files at the same time.

Although you can use a wild card (*) in the file name, you cannot use a wild card in the folder name. (Example: You cannot specify C:\*\TEST.txt.)

HULFT does not monitor files whose names are specified with a wild card (*) and that in absolute path exceed 200 bytes.

When the client is Ver.8.1 or higher

Specify a file name that does not include the directory name.

If you have specified 'No' (N) for the Use Regular Expression, you can use a wild card (*) to monitor multiple files simultaneously.

If you have specified 'Yes' (Y) for the Use Regular Expression, you can use a regular expression but you cannot use a wild card (*).

(A4) Job ID

This field specifies the ID of the job that HULFT starts when the creation, deletion, or modification of files is detected.

(A5) Monitor Subdirectories

This field specifies whether or not to monitor subfolders.

In addition to the folder that is specified in the Path to Directory, specify whether or not to monitor its subfolders.

<Table> Setting Values for Monitor Subdirectories

On-screen
Options
Values in
CSV File
Description
Yes Y Monitor subfolders
No N (default value) Do not monitor subfolders

(A6) Use Regular Expression

This field specifies whether to use regular expressions.

Specify whether to use regular expressions to specify file names.

<Table> Setting Values for Use Regular Expression

On-screen
Options
Values in
CSV File
Description
Yes Y Use regular expression
No N (default value) Do not use regular expression

(A7) Monitor Creation

This field specifies the setting for monitoring for creation of new files.

Specify whether to monitor for creation of new files.

<Table> Setting Values for Monitor Creation

On-screen
Options
Values in
CSV File
Description
Yes Y (default value) Monitor
No N Do not monitor

(A8) Monitor Deletion

This field specifies the setting for monitoring for deletion of files.

Specify whether to monitor for deletion of files.

<Table> Setting Values for Monitor Deletion

On-screen
Options
Values in
CSV File
Description
Yes Y (default value) Monitor
No N Do not monitor

(A9) Monitor Modification

This field specifies the setting for monitoring for modification of files.

Specify whether to monitor for modification of files.

<Table> Setting Values for Monitor Modification

On-screen
Options
Values in
CSV File
Description
Yes Y (default value) Monitor
No N Do not monitor

(A10) Monitoring Method

This field specifies the criterion for monitoring for modification of files.

To use the Monitor Modification, specify the criterion for modification.

<Table> Setting Values for Monitoring Method

On-screen
Options
Values in
CSV File
Description
Time Stamp T (default value) Determine modification based on the time stamp of the file
File Size S Determine modification based on the size of the file

(A11) Check File Occupancy

This field specifies the check for file occupancy.

Specify whether to check if a file is being used by a different process or application.

<Table> Setting Values for Check File Occupancy

On-screen
Options
Values in
CSV File
Description
Yes Y (default value) Check
No N Do not check

(A12) Wait File Availability

This field specifies the action to take when HULFT fails in checking file occupancy.

Specify whether to wait until file occupancy can be checked, or to end when a failure occurs.

<Table> Setting Values for Wait File Availability

On-screen
Options
Values in
CSV File
Description
Yes Y (default value) Wait
No N Do not wait

You can set this field only if you have specified 'Yes' (Y) for the Check File Occupancy.

(A13) Monitoring Interval

This field specifies the interval for monitoring.

Specify the interval for monitoring, in seconds.

(A14) Activate Monitoring

This field specifies the setting for activation of monitoring for the registered trigger ID.

Specify whether to activate monitoring for the registered trigger ID.

<Table> Setting Values for Activate Monitoring

On-screen
Options
Values in
CSV File
Description
Yes Y (default value) Monitor files according to the settings
No N Do not monitor files

(A15) User Name

This field specifies the user who starts the job.

HULFT deletes any single-byte spaces before or after the string.

If you omit this setting, HULFT uses the name of the Request Acknowledge process executor for starting the job.

(A16) Domain Name

This field specifies the domain name that the user belongs to.

HULFT deletes any single-byte spaces before or after the string.

(A17) Password

Specify the password of the user for this field.

(A18) Comment

This field specifies the comment for the File Trigger Information record.

 

[Note] The actual monitoring information is not updated when you create, modify, or delete records of the File Trigger Information. To reflect the current state of the File Trigger Information, you must restart the Request Acknowledge process on the client side or execute the File Trigger Information Control command.

2. Additional information other than File Trigger Information

This additional information is displayed together with the File Trigger Information on each screen where you edit the File Trigger Information. You can view and modify this information on screens in HULFT-HUB Manager.

[Note] You cannot view this additional information on the Management screen on the client (HULFT) side.

(B1) Alias

This field specifies the alias for the file trigger.

It is recommended that you assign a unique name in the File Trigger Information so that each trigger ID that is displayed on screens in HULFT-HUB Manager can be easily identified.

(B2) Business Group ID

This field specifies the Business Group ID that uses this File Trigger Information.

(B3) Batch Distribution ID

This field shows the Batch Distribution Information ID with which this File Trigger Information is registered as distribution data.

[Remarks] You can view this field on the Collecting and Distributing System Management Information screen (cannot be modified).