Forces the operating system of the computer where the data files are found to write data onto the disk. The HFSQL context of the data file used is stored (lock, current browse, ...).
Note: Used on a regular basis, this function minimizes the loss of data caused by the unexpected system outage on the computer where the data files are located (power failure for example).
Remark: From version 19, HFSQL is the new name of HyperFileSQL.
// Add a record into a file
// (record described by programming)
Customer.LastName = "Clark"
Customer.FirstName = "Vince"
Customer.Address = "Palm lane"
Customer.City = "San Francisco"
Customer.Zip = "94102"
Customer.Country = "USA"
// Forces a write operation into Customer file
<File name>: Character string (with or without quotes)
Name of data file used.
If this name is not specified, HFlush handles the last data file used by the last function for HFSQL management (starting with the letter H).
If this parameter corresponds to "*", HFlush will be applied to all opened data files.
Caution: In this case, the execution of function can be quite long.
This parameter can also correspond to the name of a group of files (or custom-folder) defined in the analysis (not available in Android and Android Widget).
During the call to HFlush, the data file used is closed and re-opened. If locks were implemented on this data file before it was closed, these locks are automatically restored when it is re-opened. Indeed, when closing a data file, the operating system deletes the locks implemented on this data file.
Note: It is not advisable to call this function too often on:
- data files on which an important number of locks is implemented.
- data files on which an important number of write operations is implemented.
HSecurity and HFlush functions
can both be used to force a physical write operation on disk.
- HSecurity is used to force a write operation into the data files used during each write operation. This write operation is automatically performed by the HFSQL engine. The data files used are not closed during this write operation. The speed of the write-to-file operation is slower.
- HFlush is used to force a write operation into the data files used during the call to this function. The data files used are closed then re-opened during this write operation. The speed of the write-to-file operation is not slowed down.