The Table_StartConversion() function is used when a table definition has been modified and existing data must be converted so it can be used with the modified table definition. This function opens the old and new table definitions for exclusive use so data can be converted.
The Table_Start_Conversion() function can be used only for c-tree and Pervasive.SQL tables. It can’t be used for SQL tables.
• source_table – A string containing the technical name of the table from which records will be transferred.
• destination_table – A string containing the technical name of the table to which records will be transferred.
An integer indicating whether the source and destination tables were opened successfully. The values returned correspond to those returned by the err() function.
This function opens the source and destination tables for exclusive use. The destination table is actually a temporary table in the same directory as the source table being converted. After both tables are open, records can then be transferred from the source table to the destination table. Then Table_EndConversion() is used to finish the table conversion.
Before you can use this function, you must have a table definition for the source table and the destination table. Typically, you will use the Duplicate Resources utility in Dexterity Utilities to duplicate the source table definition. The duplicate table definition is saved and becomes the source table.