contact contact

B.08.30 / Reference Docs / Utilities / dbvolcreate

dbvolcreate utility

» Usage | Notes | Examples | See also
  The dbvolcreate utility is used to create the main database volume file of an Eloquence database environment and initialize the system catalog. It also adds the volume filename to the [Volumes] section of the database server configuration file.


usage: dbvolcreate [options] volume_file_name
 -v        - verbose
 -d flags  - debug flags
 -c cfg    - configuration file name
 -s sz     - Initial size
 -e sz     - Extension size
 -m sz     - Max volume size
The options are:
The -help option displays a brief help text.

The -v option causes dbvolcreate to output more detailed processing messages.

-d flags
The -d option specifies debug flags and is normally not used.

-c cfg
The -c option specifies the eloqdb server configuration file name. If not specified, the default configuration file name depends on OS platform and Eloquence version.

-s size
The -s option specifies the initial size (in MB) of the volume to be created. The default size is 2.5 MB (which is also the minimum size).

-e size
The -e option specifies the extension size (in MB). When the volume is getting full, it will be extended in steps of size MB. If size is 0, the volume will not be extended automatically by the server. The default extension size is 1 MB.

-m size
The -m option specifies the maximum volume size (in MB). Automatic volume extensions will not grow the volume beyond size MB. If not specified (or specified as zero), the maximum volume size is determined by the "VolumeFileSizeLimit" setting in the eloqdb server configuration file.


  • dbvolcreate needs write access to the eloqdb config file to update the [Volumes] section.

  • Additional (data or log) volume files may be created with the dbvolextend utility. Volume parameters "extension size" and "maximum size" may be changed with the dbvolchange utility.


The example below creates a database volume file named /data/db-01.vol and specifies that it will be extended in 100 MB increments as needed. A volume-specific maximum size is not specified.
dbvolcreate -v -c eloqdb.cfg -e 100 /data/db-01.vol

See also

dbvolextend, dbvolchange, dbvoldump.

  Privacy | Webmaster | Terms of use | Impressum Revision: 2014-08-04  
  Copyright © 1995-2021 Marxmeier Software AG