Dictionary/3000 Reference Manual (32244-90001)

Chapter 5 173
Dictionary/3000 Utilities
DICTVPD
DICTVPD
VPLUS Forms File Definition Utility
The VPLUS Forms File Definition utility (DICTVPD) enters the definition for an existing
VPLUS forms file into the Dictionary. This utility creates the entries for the forms file, the
forms in the forms file, and the data fields for the forms in the Dictionary. The forms file is
entered in the Dictionary as a VPLS type file. The forms are entered as FORM type files
and the data fields are entered as data elements in the Dictionary.
DICTVPD also establishes the associations of the data fields with the forms and the
relationships between the forms and the forms file. However, form family relationships are
not established in the Dictionary by DICTVPD. In the Dictionary, the parent forms and the
child forms in a form family will only be related to the forms file.
Before the definition of a forms file is loaded in the Dictionary, DICTVPD checks the
existing entries to avoid entering duplicate or redundant entries. If the name used for a
forms file, form or data field being loaded is the same as the name of an existing entry, a
warning message is issued. For a duplicate forms file name or a duplicate data field name,
you are given the option to either enter a new name or to use the existing entity in the
Dictionary. For a duplicate form name, you are given the option to either skip that form
(that form would not be loaded, but subsequent forms would be loaded), purge the existing
form (the form name and all associations with the form would be purged but the elements
associated with the file would not be purged), or enter a new name for the form to be
loaded.
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 DICTVPD and gives an explanation of
each prompt.
This utility assumes that the Dictionary to be used by DICTVPD is in DICT.PUB in the
Logan account. If the forms file is to be loaded in a Dictionary which is not in that group
and account, use an MPE file equation to redefine the Dictionary's location before running
this utility.
To execute DICTVPD, enter the following MPE command:
RUN DICTVPD.PUB.SYS
After an acknowledgment message, DICTVPD prompts for the Dictionary password to
open and read the Dictionary as follows:
DICTIONARY PASSWORD>
Enter the Dictionary password and press [[RETURN]]. The password must grant at least
PROGRAMMER level access to the Dictionary. (See Appendix C for an explanation of the