Main -> Documentation -> Database Builder – Newton -> OCLC SiteSearch Database Builder Utility Programs -> The Initdb Utility

The Initdb Utility

The initdb utility allows you to initialize the physical database files according to the definitions in the database description (.dsc) file. The initdb program can also be used to modify the existing database description (stored in the HEDR file) or to enlarge the size of any of the database files (see the parameters provided in the syntax below). The initdb utility stores the binary encoded database description in the first record of the HEDR file, which is where the database building program and the search engine look to retrieve the information.

Important Note: This utility performs step 2 in the database build process. It is strongly recommended that you use the SiteSearch Database Operations Tool (SSDOT) to complete the database build process. SSDOT, a component of the SiteSearch system, has a menu-driven interface that calls the appropriate database utility programs to execute the various build processes, including the tasks performed by the initdb utility.

Syntax

initdb -cdbdescfile [-dpdir_name] [-rhdir_name] [-ppost_name] [-hheader_name] [-iindx_name] [-u] [-a] [-h]

or

initdb @parmfile

Note:

If the optional parameters for the five database files are not specified as shown in the first syntax above, initdb will attempt to create files with default names of HEDR, HDIR, POST, PDIR, and INDX, respectively.

Parameter

Description

-cdbdescfile

Specifies the name of the .dsc file to work with when preparing the database files for the pippin and rome utility programs.

-dpdir_name

Overrides the default file name and creates a postings directory file of the name pdir_name.

-rhdir_name

Overrides the default file name and creates a header directory file of the name hdir_name.

-ppost_name

Overrides the default file name and creates a posting file of the name post_name.

-hheader_name

Overrides the default file name and creates a header file of the name header_name.

Note:

If you include the -h flag without a value for the header_name variable, the utility's usage statement will be displayed instead, as shown in the -h flag syntax description below.

-iindx_name

Overrides the default file name and creates an index file of the name indx_name.

-u

Uses the dbdescfile specified by the -c parameter to update the existing database description stored in the header file of the database. Refer to Creating a Database Description (.dsc) File for more information.

-a

Uses the dbdescfile specified by the -c parameter to extend the formatted size of the existing database files. See the Database File Definitions section for more information on specifying database file size.

-h

Displays the utility's usage statement.

Note:

Do not confuse the -h flag with the -hheader_name command described above.

@parmfile

Provides an alternative to using the parameters in the first syntax example above by defining the name of a parameter file, parmfile, as the single input parameter. (Refer to the second syntax description above.) parmfile contains a list of the command line parameters. To create the file, use a text editor to produce a list of the parameters to be used.

Note:

The format of the parmfile should conform to the conventions of UNIX command line parameter specifications. For example, using the blank (' ') to separate parameters and using the slash ('\') for line continuation beyond a single line of input.

See Also

An Introduction to Database Files
Database File Definitions
Creating a Database Description (.dsc) File
An Explanation of the Database Build Process
The Pippin Utility
The Rome Utility
Open SiteSearch Database Builder Utility Programs
SiteSearch Database Operations Tool (SSDOT)


[Main][Documentation][Support][Technical Reference][Community][Glossary][Search]
Last Modified: