DtvLong dal_dbi_dal_loa_ent (idn)

Re-initializes or updates the entity definition of the entity-Id in local memory.

Input Parameters Significance
DtvLong idn entities-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 entity definitions in the entity-relationship-model of your application are copied from the data base into local memory and initialized.

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

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

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