D_INITIALIZE

SUMMARY
   d_initialize([dbn])
   int dbn;

ARGUMENTS

   dbn         (optional)The number of the database containing the record

DESCRIPTION
   This function initializes the database files in the open db_VISTA database.
   If multiple databases are open ,all are initialized.


───────────────────────────────────────────────────────────────────
NOTE

   This function can only be called when databse is opened in exclusive
   or one-user-only access mode.

   In db_VISTA 3.00 for DOS enviroments ,this function did not require the
   presence of the data/or key file to function.However, for UNIX
   enviroments, it did.This has been changed with db_VISTA 3.10. The
   data and/or key files now must exist in order for this function
   to work .You will get an S_NOFILE (-905) error if any file is missing.
   This change was made db_VISTA behave the same regardless of the platform
   which it is runnig.
───────────────────────────────────────────────────────────────────

CURRENCY CHANGES
   None

RETURN CODES

   -32   S_EXCLUSIVE        Function requires exclusive or one-user database
                            access.

EXAMPLE

       d_open("work","o");
       d_initialize();

       ........
       /* built and access work database */


       /* all done close database and delete files  */

       d_destroy("work");