HP System Dictionary/XL General Reference Manual Vol 2 - Part 1 SDINIT (32256-90005)

10- 85
Compile / Merge Options
You can set various options for the compile/merge process via two commands: The COMPILE-OPTIONS
command, which allows you to set the options for the compiling process, and the MERGE-OPTIONS
command, which allows you to set the options for the merging process. Note that these options must be
specified before the COMPILE or MERGE command is given.
Compiling / Merging Multiple Versions
You can compile or merge more than one version when running SDUTIL by issuing multiple COMPILE or
MERGE commands and specifying the appropriate source and target environments as necessary. Note that
multiple versions can be compiled into the same compiled dictionary until the compiled dictionary is
closed.
Compiling a Dictionary
When you are compiling, the dictionary structure and the security schemes are automatically included in
the compiled dictionary. However, you have an option to specify whether or not you want common links to
be compiled. If this option is set true, and the version to compile is in the local domain and it is linked to a
version in the common domain, then the linked version in the common domain will also be compiled in
addition to the version in the local domain. The occurrence linking will then be preserved in the compiled
dictionary as in the source master dictionary. You also have an option to specify what variable length
attributes you want to compile. You can include all, none or selected variable length attributes in your
compiled dictionary.
Closing the Compiled Dictionary File. The compiled dictionary is closed when you
• enter an EXIT command.
• change the source dictiona ry to a different dictionary specified by the FROM command.
• change the compiled dictionary file name to a different file name, specified by the COMPILE-TO com-
mand.
Merging Dictionary Data
You can merge either dictionary structure from one dictionary to another, or a version from the source
dictionary to a new or existing target version in the same or a different dictionary. Since only read access
is allowed for a compiled dictionary, the target dictionary must be a master dictionary.
Previewing a Merge Option. The PREVIEW command is provided to allow you to see the results of a
potential merge before the merge actually takes place. You can then choose how any reported conflicts
between structure or occurrence definitions in the source and target dictionaries should be handled before
the target dictionary is changed.
Merging Structure Vs. Occurrence. Structure is merged only when the source dictionary is not also
the target dictionary. Occurrences, however, can be merged between versions within the same dictionary
or between two different dictionaries.
When occurrences are merged within the same dictionary, no structure changes are involved because both
versions already use the same structure. When they are merged into different dictionaries, however, the
source dictionary structure will be merged into the target dictionary. This is necessary because System
Dictionary requires a structure definition to support each type of occurrence in the dictionary. For example,
there cannot be any entities of type RECORD in a dictionary if there is no entity type RECORD in the
dictionary structure. Refer to the HP System Dictionary/V General Reference Manual, Volume 1 for a
complete explanation of dictionary structure and occurrences.
The COMPLETE-STRUCTURE option is provided so that when me rging dictionary structure, you can
specify whether to merge the whole dictionary structure, or only those structures in the source dictionary