Dictionary/3000 Reference Manual (32244-90001)

178 Chapter5
Dictionary/3000 Utilities
DICTVPD
this forms file. This form will not have any data fields associated to it. Also, $REFRESH
will not appear on the reference list for the forms file but will appear when the Dictionary
is accessed by the program DICTDBM.
As each form is loaded in the Dictionary, the following message will appear:
LOADING FORM: formname
If DICTVPD finds an existing entry in the Dictionary with the same name as the form to
be loaded, the following warning and prompt are issued:
*WARNING: DICTIONARY ALREADY CONTAINED FORM: formname
SKIP, PURGE OR ENTER NEW FORM(S/P/N)>
If S is entered in response to this prompt, DICTVPD will ignore the current form and
proceed to load the next form in the forms file. If P is entered, DICTVPD will purge the
existing form in the Dictionary along with all the associations it may have. Note that the
elements themselves are not purged, only the associations to the form are purged. Once
the existing form has been purged, DICTVPD will load the form which belongs to the
forms file in the Dictionary. If N is entered in response to this prompt, a new prompt is
issued to rename the form to be loaded as follows:
NEW FORM NAME>
Enter a new name for the form. This name must be unique to the Dictionary or DICTVPD
will reissue the warning and prompts above. The original name used for the form in the
forms file becomes the alias name in the Dictionary. The new name entered becomes the
primary name in the Dictionary.
As each form is loaded in the Dictionary, DICTVPD checks that there are no data field
name conflicts between the existing elements defined in the Dictionary and the data fields
currently being loaded. For instance, if Y was entered in response to the DATA
ELEMENTS ALREADY DEFINED prompt and DICTVPD can not find the existing entry
for a data field being loaded, the following message will be issued:
ELEMENT NOT DEFINED, NEW ELEMENT LOADED: element
This indicates that DICTVPD has loaded the specified data field from the forms file in the
Dictionary as a new element entry.
If N was entered in response to the DATA ELEMENTS ALREADY DEFINED prompt,
DICTVPD will still check for existing data elements in the Dictionary with the same name
and compatible definition. If DICTVPD finds a duplicate entry in the Dictionary and the
data type and data size are compatible with the data field to be loaded, DICTVPD will
issue the following message and prompt:
COMPATIBLE DEFINITION ALREADY IN DICTIONARY FOR ELEMENT element
DO YOU WANT ELEMENT TO HAVE A DIFFERENT NAME(N/Y)>
Enter N to use the existing entry in the Dictionary for this element. Enter Y to rename the
element being loaded. A new prompt will then be issued:
NEW PRIMARY ELEMENT NAME>