Dictionary/3000 Reference Manual (32244-90001)

160 Chapter5
Dictionary/3000 Utilities
DICTDBD
If you enter a “Y”, the loading process continues. If you enter an “N” or [[RETURN]], you
are prompted to rename the element as follows:
NEW PRIMARY ELEMENT NAME>
A unique name for the element must be entered. The name for the item in your database
becomes the alias name for the item in the Dictionary. If you enter [[RETURN]], the
program does not load the element into the Dictionary and issues the following warning:
*WARNING: ELEMENT HAS NOT BEEN LOADED INTO DICTIONARY
Then the loading process continues. Each time an existing compatible entry is
encountered, the above sequence occurs. If an incompatible item is encountered, the
following sequence occurs:
INCOMPATIBLE DEFINITION ALREADY IN DICTIONARY FOR ELEMENT element
NEW PRIMARY ELEMENT NAME>
You must enter a unique element name in response to the prompt. If you enter
[[RETURN]], the program does not load the element into the Dictionary and issues a
warning message.
After checking the data items, the utility compares the data set definitions with existing
Dictionary entries. The definition of a data set includes the data items within the set. If
there are no other identical entries, the transfer is completed and the program terminates.
If an identical entry for the data set exists, the following message and prompt are issued:
DEFINITION ALREADY IN DICTIONARY FOR SET set
USE EXISTING DEFINITION(N/Y)?>
If you respond with an “N”, you are prompted to rename the set as follows:
NEW PRIMARY FILE NAME>
A new, unique name, must be entered. By entering “Y” or [[RETURN]], the data set is not
loaded and a warning message as follows is issued:
*WARNING: DATA SET HAS NOT BEEN LOADED INTO DICTIONARY
Each time the program encounters an existing identical definition, the above process is
repeated. If an existing definition is incompatible, the following message and prompt are
issued:
DEFINITION ALREADY IN DICTIONARY FOR SET set
NEW PRIMARY FILE NAME>
A unique name must be entered for the data set. If [[RETURN]] is used, a warning is
issued.
The above process continues until the entire schema has been compared with existing
Dictionary entries. When the comparison is complete, the transfer, where indicated by
your responses to the prompts, is completed. The DICTDBM program could be executed to
view the transferred definition.
The following examples show how to execute the Database Definition utility with a brief
explanation of the prompts and responses.