company logo

DataSource :: openResourceDatabase - Open resource database

The resource database handle for the resource database defined in the resource database path will be opened. Opening the resource database requires an opened system dictionary. When the database handle is already opened, it will be closed before opening the new database handle (closeResourceDatabase()).

When the client is an object server client, the resource database will be opened as local database, when the system dictionary has been opened locally. In order to open a server resource database, the system dictionary must have been opened as server dictionary in the SYSTEM section of the configuration file. For a server resource database, a symbolic path name has to be set in the resourceDatabasePath option (e.g. %SampleDev%).

In case of replication server, resource databases should be defined as local resource in any case.

Return value:  Database handle ( odaba::Database & )

The database handle refers to an (usually) opened database. Calling functions with invalid database handles may cause an exception. For checking the database handle, isValid() can be called.

Implementation details

odaba::Database & DataSource  :: openResourceDatabase (  )