HP 3000 Manuals HP 3000 Manuals
MERGE-OPTIONS
Sets various options to take during the merge and preview processes.
Syntax
MERGE-OPTIONS [;COMPLETE-STRUCTURE=complete-structure-option]
[;SECURITY=security-option]
[;VERSION-CONFLICT=version-conflict-action]
[;NAME-CONFLICT=name-conflict-action]
[;INCOMPATIBLE-DEFINITION=incompatible-defn-action]
[;COMPARE-VAR-ATTR=var-attribute-list]
[;LINK=common-link-option]
{.}
Parameters
complete- This option allows you to specify whether or not you
structure- want to merge the complete structure of the dictionary
option you are in. Valid options are:
TRUE
FALSE
The default is FALSE which means that when you are
merging a version in a domain, only those structures
that involve occurrences in the specified version will
be merged.
security- This option allows you to specify how to handle the
option merging of security to a dictionary. Valid options are:
COMPLETE
OWNED
ACCESSIBLE
Option COMPLETE allows you to merge all security
information. Occurrence ownership will be maintained by
their ownerships as in the source dictionary. In
addition scope entity and scope relationship
associations will be merged also. This option can be
used only if you are the DA.
Option OWNED allows you to merge the occurrences owned
by the logon scope only.
Option ACCESSIBLE allows you to merge all occurrences
accessible to the logon scope regardless of who owns it.
This is the default option.
When either OWNED or ACCESSIBLE is specified, no
security will be merged. Both of these options will
merge the occurrences to the target logon scope, so the
scope ownership in the source and target dictionaries
may not be the same.
version- When a version is merged into a dictionary, the same
conflict- version may already exist in the dictionary. This
action option allows you to take appropriate action when this
occurs. Valid options are:
EXIT
MERGE
NEW
PROMPT
SKIP
Option EXIT will end the program. Option MERGE allows
you to merge definitions into the same version leaving
the existing occurrences in the version. Option NEW
will prompt for a new version name. If you are not in
the common domain, and LINK option is true, you will be
prompted for the common version name as well. Option
PROMPT will issue this prompt:
Version xxx exists. Exit, Merge, enter New name
or Skip (E/M/N/S)?
Enter the option of your choice. Option SKIP will skip
merging this version.
The default is PROMPT if you are running in session mode
and SKIP if you are running in batch mode.
name-conflict- When creating a new entity in the target dictionary, the
action external name may conflict with an existing external
name. This option allows you to take the appropriate
action to resolve the external name conflict. Valid
values are:
EXIT
NEW
PROMPT
SKIP
TERMINATE
Option EXIT will end the program. Option NEW will
prompt you to enter a new external name. Option PROMPT
will issue the following prompt for action:
Exit, enter New name, Skip, Terminate (E/N/S/T)?
Option SKIP will skip the entity, option TERMINATE will
terminate the merge process and continue to read the
next SDUTIL command.
The default for this parameter is PROMPT if you are
running in session, and SKIP if you are running in
batch.
incompatible- When an occurrence (entity or relationship) is merged
defn- action into a dictionary, it may have already existed. If the
definition in the dictionary has the same attribute
values as the one to be merged, then it is considered
compatible and no action will take place for that
occurrence. However, if the source and target
occurrences have different attribute values then you
will be given the following options to handle the
conflict:
EXIT
PROMPT
REPLACE
SKIP
TERMINATE
Option EXIT will end the SDUTIL program. Option PROMPT
will issue the following prompt:
Exit, Replace, Skip or Terminate (E/R/S/T)?
Option REPLACE will replace the existing definition's
attributes with the source definition's attributes.
Option SKIP allows you to skip over the conflicting
definition leaving the existing definition in the
dictionary. Option TERMINATE will terminate the merge
process and continue to read the next SDUTIL command.
The default is PROMPT if you are running in session, and
SKIP if you are running in batch.
var-attribute- Comparing variable length attribute values to determine
list the compatibility is very time consuming. Therefore,
SDUTIL will automatically merge (replace) the variable
length attribute values from the source. If you need to
compare the variable length attribute values to take the
INCOMPATIBLE-DEFINITION action, enter the attribute
name(s) in a list format separated by commas. If the
source dictionary is not also the target dictionary,
then the names entered correspond to the names of the
variable length attributes found in the source
dictionary. If the values are compatible, SDUTIL will
not take any action. If they are incompatible,
SDUTIL will take the action specified in the
INCOMPATIBLE-DEFINITION option. If you wish to compare
all of the variable length attributes, specify
COMPARE-VAR-ATTR=!. If you don't wish to compare any,
specify COMPARE-VAR-ATTR=. The default is not to
compare any.
common-link- This option allows you to specify that if a source
option occurrence is linked to an occurrence in a version in
the common domain, the target occurrence is to be linked
also. It is only applicable if the source or target is
not in the common domain and is linked to a version in
the common domain. Valid options are:
TRUE
FALSE
The default is TRUE.
Discussion
Once a parameter in the MERGE-OPTIONS is specified, its value will be
retained until a new value is specified. See Chapter 2 for more details
regarding merge options.
Example
>MERGE-OPTIONS INCOMPATIBLE-DEFINITION = replace;
>>COMPARE-VAR-ATTR = edit-mask;
>>VERSION-CONFLICT = merge.
>