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.