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.