DtvLong dal_dbi_dal_loa_tab (idn)

Re-initializes or updates the table definition for the table Id in local memory.

Input Parameters Significance
DtvLong idn table Id [0 = all]

Output Parameters Significance
no -

Return Code Significance
0 no error
1 data structure not initialized yet
2 ident number does not exist
-1 data base error reading the table data

This function is executed by DataView at the program start (opening the data base in the module MAIN.C). In this process all table definitions in the entity-relationship-model of your application are copied from the data base into local memory and initialized.

When you load table definitions into local memory, DataView will use the information in local memory and not those in the data base for all table queries from within DataView standard functions.

If you do not pass a table Id (idn = 0), DataView will copy all table definitions from the data base into local memory, just like at program start. Thus you can re-initialize the table definitions in local memory.

The function loads the data unsorted. The object names are sorted into a MAP for a faster InCore query.