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

10- 84

Name Modes

When dictionaries are either compiled or merged, both the internal and external names are affected,

regardless of the name mode that is speciﬁed. The name mode parameter of the FROM and MERGE-TO

commands allows you to specify either the internal or external names for the scope name, domain name

and version name when opening the dictionary. When merging, however, SDUTIL checks only internal

names to determine whether or not a deﬁnition exists. Internal names are used because they can never be

changed, while external names can be.

Open Modes

SDUTIL allows you to choose the open mode with which to open the source and target dictionaries in the

FROM and MERGE-TO commands.

The FROM command is used to deﬁne the source environment for both compiling and merging.

If you are compiling, open the source dictionary in either Exclusive-Update mode or Read-Allow-Read

mode, unless you are compiling structure only. If you are compiling structure only, you may open the

source dictionary in Exclusive-Update mode, Read-Allow-Read mode, or Customization mode.

If you are merging, the source dictionary can be opened in any mode. Some general guidelines for source

dictionary open modes used while merging are:

• Open the source dictionary in Customization mode if you only want to merge the complete dictionary

structure and do not want to specify a version and domain when opening the dictionary.

• Open the source dictionary in either Read-Only mode or Shared-Update mode if you do not care if some-

one is modifying the dictionary while you are merging either structure-only or a version.

• Open the source dictionary in either Exclusive-Update mode or Read-Allow-Read mode if you do not

want anyone to modify the dictionary while you are merging either structure-only or a version.

The MERGE-TO command is used to deﬁne the tar get environment for merging only. You can open the

target dictionary in Read-Only mode only if you are previewing the merge process. Otherwise use the

following guidelines for target dictionary open modes.

• Open the target dictionary in Customization mode if yo u are merging structure only and want exclusive

access to the target dictionary.

• Open the target dictionary in Exclusive-Update mode if you are merging a version and expect structure

changes are to be involved. This will ensure that no one else is accessing the dictionary during the

merge, and the dictionary can be switched to Customization mode when updating the structure. The

switch is done automatically, so you don't have to merge structure separately first, and then merge oc-

currences, but can do them both at once.

• Open the dictionary in Shared-Update mode if you are merging a version, do not expect structure chang-

es, and do not need exclusive access to the target dictionary while you are merging.

compiled dictionary master dictionary FROM

MERGE-TO

MERGE-OPTIONS

MERGE/PREVIEW

compiled dictionary compiled dictionary NOT ALLOWED

Table 7: MERGE AND COMPILE COMMANDS

From To Command