Request_Clear_File - BaseData_Set

Performs the Clear command on the specified table of the data-server structure

Type: Procedure

Parameters: Integer iFile

Parameter Description
iFile Number of the table in the current filelist

Parameter	Description
iFile	Number of the table in the current filelist

Syntax

Procedure Request_Clear_File Integer iFile

Call: Send Request_Clear_File iFile

Description

The Request_Clear_File procedure performs the Clear command on the specified table of the data-server structure. It is intended to be used to clear a table and notify this object that the table is actually cleared. This ensures that the refresh of data-entry objects that may occur afterwards will properly clear entry_items for the specified table . (If the Clear command alone is used, the refresh will not clear the entry_items for the specified table). It is intended to be used in an augmentation of the Clear_Main_File procedure to force a manually related table (see the Relate_Main_File message) to be cleared when the main table is being cleared.

Sample

Procedure Clear_Main_File
    // clear_main_file normally
    Forward Send Clear_Main_File

     // also clear "manually" related files
    Send Request_Clear_File Manual1.File_Number
    Send Request_Clear_File Manual2.File_Number
End_Procedure