HP 3000 Manuals HP 3000 Manuals
MERGE-TO
Specifies the target dictionary.
Syntax
MERGE-TO [;DICTIONARY=dictionary-filename]
[;SCOPE=scope-name]
[;PASSWORD=[scope-password]]
[;NAME-MODE=name-mode]
[;OPEN-MODE=open-mode]
[;DOMAIN=[domain-name]]
[;VERSION=version-name ]
[;STATUS=version-status]
[;COMMON=common-version-name] {.}
Parameters
dictionary- Filename of the dictionary to be opened. The default
filename for this parameter is SYSDIC if not specified when
opening the dictionary.
scope-name Name of the scope to open the dictionary with. This
parameter is required when opening the dictionary.
scope-password Gives access to the scope. Any characters are allowed
in a password. If a character in the password is NOT
valid in other System Dictionary names (ie. is in the
restricted list), the password must be entered inside a
pair of quotes to allow recognition of the 'restricted'
characters.
If the SCOPE parameter is specified and the PASSWORD
parameter is not, you will be prompted for the password.
For security reasons, the echo is turned off and you are
given only three chances to enter the correct password.
If you're running the program interactively and the
correct password is not entered after three tries, the
MERGE-TO command will terminate and you will be returned
to the highest prompt level. If you're running the
program in batch mode and the correct password is not
entered, the program will terminate. The password is
always read from $STDINX.
The scope that you chose should give you enough
capabilities to complete the merge process. For
example, if structure changes are involved when merging
a version, the scope that you open the dictionary must
have Extend capability. Another example is when you are
merging definitions, the scope that you open the
dictionary should have modify access to the occurrences
in the version so the merge procedure will not fail due
to the dictionary security.
name-mode Specifies which name mode to open the dictionary with.
The valid choices are:
Internal
External
The default is to use the external name mode.
open-mode Specifies which mode to open the dictionary with. The
valid choices are:
Read-Allow-Read
Read-Only
Shared-Update
Exclusive-Update
Customization
If not specified, the default is Shared-Update mode.
After the dictionary is opened, this parameter can be
used to change the open mode.
Customization should only be used if you are merging
only the structure. When merging occurrences that
involve structure changes, you should open the
dictionary in exclusive-update mode. This is because
SDUTIL will have to switch to customization mode during
structure update, and it may not be successful unless
the dictionary was opened exclusively.
domain-name Name of the dictionary domain to merge definitions to.
If not specified the default is (will be) the same as
the source domain at merge time. If you are in another
domain and you want to get back to the common domain,
specify DOMAIN= with no value. If you are in another
domain (specified by you) and you want to default to the
source domain, specify DOMAIN= !. Once an exclamation
point ''!' is specified, it will remain defaulted to
the source until you specify another domain.
The domain specified must already exist in the target
dictionary, otherwise the merge process will not be
successful.
version-name Name of the version to be used when merging definitions.
If not specified, the version status parameter is used
to determine the default version. If both the
version-name and the version status are not specified,
then the default is (will be) the same as the source
version at merge time. If you are in another version
specified by you, and you want to default to the source
version specify VERSION = !. Once a version is
defaulted to the source, it will remain defaulting to
the source at merge time, until you specify another
version. If the version specified does not exist, a new
version will be created at merge time.
version- status Used to default the version to the latest test,
production, or archival version of definitions. The
valid choices are:
Test
Production
Archival
Note that the production and archival status are valid
only if you are previewing the data and not merging.
The status is determined by the version-name parameter.
common- Name of the version in the common domain to be linked to
version- name the specified version. This parameter is used only if
you are actually merging, the target version is not in
the common domain, and LINK option is true. The default
is the same as the source. If you are in another
common-version and want to default to the source
common version name, specify COMMON=!. Once the
common-version-name is default to the source, it will
remain defaulting, until you specify another
common-version-name. For more information concerning
the linking of versions, refer to Chapter 2.
Discussion
Before the merge process can begin, the environment to which the
definitions or structure are to be merged must be defined. The target
dictionary must be a master dictionary. Once a parameter in the MERGE-TO
command is specified, its value will be retained until a new value is
specified.
Example
>MERGE-TO DICTIONARY=sysdic.pub;
>>SCOPE=manager;
>>PASSWORD=mgr*;
>>VERSION=version-1;
>>OPEN-MODE=shared-update.
>