Pears Database Description Configuration File

Contents

Introduction
Sections in a Database Description Configuration File

[Bartlett]
[DB]
[Record Handler Section]
[Indexing Rules Section]
[LockServer]

Example Database Description Configuration File


Introduction

A Pears database description configuration file contains the rules for creating a Pears database. It is divided into various sections in which you can set block size, declare input record format, and define indexes. Optionally, you may also include a section in the file to reference a specific record handler.

Sections in a Database Description Configuration File

The following sections make up a typical database description configuration file:

Section Description
[Bartlett] Optional Contains optional parameters specific to the Bartlett utility
[DB] Required Declares file and formatting characteristics for the database
[ Indexing Rules Section] Required Contains an index definition for each separate index for the database
[ Record Handler] Dependent

Sets parameters for the specific record handling class that is used to convert the input data into database records

Example:
[HandleUSMARC]
deleteChars=d

Note: Some record handling classes ( record handlers) require or need additional parameters in order to interpret and convert input data successfully. These parameters vary according to the record handler being used and the nature of the data being imported into the database.

[LockServer] Optional Declares the host and port for the lock server that prevents the same database from being updated by two simultaneous Bartlett sessions

Parameters in Each Section of a Database Description Configuration File

[Bartlett] Section - Optional for: All

Parameter Description
badRecordMessageFile Contains the text of a message when a record is not successfully committed to the database during a load

[DB] Section - Required for: All

Parameter Description
blocksize Sets the size of each file block in the database (.pdb) file for the storage of data and indexes
InputRecordType Declares the record format of the input file so that Bartlett uses the correct record handling class to inport the data
RecordIDIndex Points to the index within the database description configuration file that is mapped to the unique ID field within each record
Name Declares the name of the database

[Record Handler] Section - Optional for: All

Parameter Description
Various parameters

The parameters and their settings within this section vary according to the record handler that is being used and the nature of the data being imported.

Note: The section name must match the name of a valid record handler and must also correspond with the InputRecordType declared in the [DB] section of the same database description configuration file.

[Indexing Rules] Section - Required for: All

Parameter Description
[ rule label] This is the descriptive label for a specific index. You may choose any label you like, although we recommend something meaningful that suggests the index's type, purpose, or content. The label must be unique, but is not linked to a corresponding item in a list located somewhere else within the database description configuration file.
index=

Unique index ID that is used internally to identify an index from all others for a particular database

Notes: The index ID is used to map an index defined in a WebZ database configuration file to its corresponding index in the .pdb file, which ultimately provides searcher access to a database from the WebZ Interface.

tagpath*

BER field tags that represent the sequence of nested parent and data tags within a record that must be traversed in order to find the term(s) to be indexed

Note: Since most indexes are collections of terms from different fields within a record, an index definition often has multiple tag paths.

routine References the specific class ( index routine) that is used to extract terms and build an index

[LockServer] Section - Optional for: All

Parameter Description
Host Name of the host on which the lock server is running
Port Port on the host at which the lock server listens

Example Database Description Configuration File

The following example is a database description configuration file for a MARC database:

[DB]
blocksize=16384
InputRecordType=ChinaMarc
Name=tsinghua
RecordIDIndex=1

[Accession Number]
index=1
routine=ORG.oclc.pears.IndexRoutines.Phrase tagpath*=001

[Date Completed]
index=2
routine=ORG.oclc.pears.IndexRoutines.Phrase tagpath*=022/37

[Catalog Language]
index=3 routine=ORG.oclc.pears.IndexRoutines.ISO639Language tagpath*=031/37

[Document Language]
index=4 routine=ORG.oclc.pears.IndexRoutines.ISO639Language tagpath*=040/37

See Also

Pears Contact

Content Last Modified: March 28, 2001

We are a worldwide library cooperative, owned, governed and sustained by members since 1967. Our public purpose is a statement of commitment to each other—that we will work together to improve access to the information held in libraries around the globe, and find ways to reduce costs for libraries through collaboration.