Dictionary/3000 Reference Manual (32244-90001)

Chapter 5 159
Dictionary/3000 Utilities
DICTDBD
After accepting the password you entered, the utility prompts you to enter specific
database identification information as follows:
BASE>
BASE PASSWORD>
MODE>
You respond to the prompt for BASE by entering the name of the database to be defined in
the Dictionary for you. The BASE PASSWORD prompt should grant read access to the
utility for the named database.
The MODE prompt indicates the access mode to be used by the utility to open and read the
database. The database can be opened in any mode. If [[RETURN]] is entered as the
response, the base is opened in the default mode which is 5. (Refer to the IMAGE/3000
Reference Manual for details on “Access Modes”.)
The process of transferring the definition of the database begins after you respond to the
prompt for MODE. A message “LOADING DATA DICTIONARY” is displayed. The utility
begins by checking whether the entire definition of the database will fit in the Dictionary.
If it will not, the following prompt is issued:
ENTIRE DEFINITION OF DATABASE WILL NOT FIT IN DICTIONARY.
PROCEED (N/Y)?
A response of “N” or [[RETURN]] terminates the utility. Responding “Y” allows the utility
to continue; however, the utility will issue an error message and terminate when any one
of the data sets is full. Note that if the entire definition of the database will not fit in your
Dictionary, you can run DICTINIT to re-initialize Dictionary with larger capacities
specified (see Appendix C).
Next, the utility checks the schema of the named database with the entries in the
Dictionary. If there are no entries identical to those in your database, the transfer is
completed and the DICTDBD utility program is terminated. You can immediately execute
the DICTDBM program and see the transferred database definition.
If an entry already exists for the database name, the following message and prompt are
issued:
*ERROR: BASE ALREADY DEFINED IN DATA DICTIONARY
DO YOU WANT TO LOAD UNDER A DIFFERENT NAME(Y/N)?>
A response of an “N” terminates the execution of the program. If a “Y” or [[RETURN]] is
entered, the following prompt to rename your database is issued:
NEW BASE NAME>
The name you enter must be unique - that is, it must not already exist in the Dictionary. If
it does, an error message is displayed and the prompt reissued. The utility program
terminates if [[RETURN]] is entered as your response to this prompt.
Next the ITEMS as listed in the schema are checked. If there are no existing Dictionary
entries, the loading process continues. If an entry already exists and is compatible with the
item in the database, the following message and prompt are displayed:
COMPATIBLE DEFINITION ALREADY IN DICTIONARY FOR ELEMENT element
USE EXISTING DEFINITION(N/Y)?>