DtvLong dal_dbi_dal_loa_rel (idn)

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

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

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

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

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