Dictionary/3000 Reference Manual (32244-90001)

158 Chapter5
Dictionary/3000 Utilities
DICTDBD
DICTDBD
Database Definition Utility
The Database Definition utility (DICTDBD) enters the definition for an existing IMAGE
database into the Dictionary. DICTDBD creates the entries for the database, the data sets,
and the data items by using the root file. The database is entered in the Dictionary as a
BASE type file. The automatic, master and detail data sets are entered as AUTO, MAST,
and DETL type files respectively. The data items are entered as elements. DICTDBD also
establishes the associations of the data items to the data sets and the relationships of the
data sets to the database.
However, the existing security defined for the database is not transferred to the Dictionary
by DICTDBD. To create or redefine security for the database, use the Dictionary Database
Maintenance program (DICTDBM). See Section III of this manual on how to define
security for a database.
Before the definition of the database is entered into the Dictionary, DICTDBD checks the
existing entries to ensure that the database does not already exist in the Dictionary. If the
database name is the same as the name for an existing entry, a message is issued. You are
given the option to change the name of the database or to terminate DICTDBD. DICTDBD
also checks the existing entries to avoid entering duplicate or redundant entries for data
sets and data items. If any of the names used for the data sets or data items is the same as
the name for an existing entry, a message is issued. For duplicate data sets and data items,
you are given the option to either enter a new name for that entity or to use the existing
entity in the Dictionary.
Whenever a name is changed for an entity being loaded into the Dictionary, the new name
entered becomes the “primary” name for that entity. The original name then becomes the
“alias” name for that entity in the Dictionary. Because HP Inform will reference these
entities by their aliases, the original names used by VPLUS do not have to be changed to
be consistent with the Dictionary. However, since DICTDBM uses the primary names for
all entities, it is important to remember what the new primary names are for the entities
whose names were changed. The following description explains how to execute DICTDBD
and gives an explanation of each prompt. To execute DICTDBD enter the following MPE
command:
RUN DICTDBD.PUB.SYS
After an acknowledgment message, DICTDBD prompts for a password to open and read
the Dictionary. The prompt is:
DICTIONARY PASSWORD>
The password that you enter must grant at least PROGRAMMER level access to the
Dictionary. (See Appendix C for an explanation of the levels of access.) If you press
[[RETURN]] in response to this prompt, the utility terminates. The password that you
enter is not displayed on your terminal, but if it is not entered correctly, an error message
is displayed and the prompt reissued.