Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 2 Configuring the Data Object Broker : Database Definition File (dbdef)

Database Definition File (dbdef)
The database definition file, dbdef, defines the Pagestore (segments and page files), which is the actual data store, as well as the audit log, the contingency log, the journal, and the redolog. It resides in the TIBCO Object Service Broker \database directory.
TIBCO Object Service Broker uses the dbdef file during initialization. The dbdef file centralizes all database structure information.
For the structure and syntax of the dbdef file, refer to TIBCO Object Service Broker for Open Systems Utilities.
This file should not be changed without careful consideration of existing TIBCO Object Service Broker files. When data exists in a particular segment, changing a value in the database definition can cause the segment to become unusable or can corrupt data in that segment.
File Naming Conventions
To provide file naming consistency, several rules apply:
TDS page data files belonging to the same segment do not have to reside in the same directory. They can reside on different disks or in different paths, provided each of them resides in the parent directory named by the segment. For example, the following two page data files reside in the same segment (in Windows):
f:\SEG01\PAGE1
g:\SEG01\PAGE2
JOURNAL1, JOURNAL2, REDOLOG, AUDITLOG, and CLOG are the default names for corresponding log files. Each file must reside in the parent directory named in the NAME parameter.
Refer to Data Object Broker Files for more information.
How File Location is Determined
The PATH parameter and FILE subcommand provide information about file location to the Data Object Broker. The following rules apply to the DB line:
The path to each TIBCO Object Service Broker file is determined by:
The value of the environment variable HURON, if the PATH parameter is not used on either the DB line or the FILE subcommand line
Changing File Location
Files that are formatted for TIBCO Object Service Broker can be relocated by moving or copying them. They can be used again without reformatting as long as you change dbdef to reflect the new file location. Data Object Broker special files are automatically formatted during a Full installation. Additional page or log files must be formatted manually using the hrntlfxx utilities. For each of these utilities you must provide the full path name of the file, as defined in the dbdef file.
Use the hrnbrial utility to move the audit log, if you want to move it. The hrnbrial utility does not move the audit log segment if it was already moved once.
See Also
TIBCO Object Service Broker for Open Systems Managing Backup and Recovery for more information about journal processing.
TIBCO Object Service Broker for Open Systems Utilities for more information on the formatting utilities and hrnbrial.
TIBCO Object Service Broker Parameters for more information on parameters.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved