Managing ObjectStore

osload: Loading Databases

To load a database or group of databases from an osdump-generated ASCII file, build the executable osload from the corresponding osdump-generated source.

On UNIX, use the make utility and the osdump-generated makefile makefile.unx. On Windows, use nmake and the osdump-generated makefile makefile.w32.

The utility osload creates a database or group of databases given osdump-generated ASCII as input. The resulting databases are equivalent to the ones from which the ASCII was produced.

Syntax

osload [ options ] db_table.dmp pathname ...


db_table.dmp
Database table dump file generated by osdump. Records information about the dumped databases.


pathname ...
One or more pathnames, separated by spaces, specifying the ASCII dump files to be loaded.

db_table.dmp	Database table dump file generated by osdump. Records information about the dumped databases.
pathname ...	One or more pathnames, separated by spaces, specifying the ASCII dump files to be loaded.

Options


-cwd	Tells osload to recreate databases in the current working directory.
-cache cache (-c) cache	Sets cache size to the specified value cache in bytes. The default is 24 MB.
-debug level (-d) level	Sets debugging level to the specified value level if debugging information is available. The range is 1-6. The default is that debugging information is not displayed.
-pages pages (-p) pages	Sets the pages fetched from databases created to the specified value pages. The default is 8.
-policy { 0 \| 1 \| 2 } (-f) { 0 \| 1 \| 2 }	Sets the fetch policy of databases created to page (0), stream (1), or cluster (2). The default policy is page (0).
-size size (-s) size	Sets the address space size to the specified value size in bytes. The default is OS_AS_SIZE.
-table tablefile -tab tablefile	Specifies the name of the database table file to be loaded. The default is db_table.dmp.
-threshold threshold (-t) threshold	Sets the address space usage threshold to the specified percentage value threshold. The range is 0.00-1.00. The default is 0.50.
-workdb workdb (-w) workdb	Specifies the name of the temporary work database.

Description

For given ASCII input, the databases created by osload have the same file names as the databases from which the ASCII was generated (as stored in db_table.dmp).

If switch -cwd is not set, the databases have the same pathnames (as stored in db_table.dmp). If files with the given paths already exist (for example, because the dumped databases are still in their original locations), osload aborts. This prevents you from overwriting your original databases.

-cwd forces osload to ignore paths from db_table.dmp and create the databases in the current working directory.

Converting a Database

osload is used with osdump to update an ObjectStore database with a Release 5.1 format to one with a Release 6.0 format. Refer to osdump: Dumping Databases for specific steps in the conversion process.

[previous] [next]

Updated: 03/11/99 11:19:07