1  merge

2  file
Merges the contents of an interim file that has been created with
the DUMP SUBTREE command into an existing subtree.

SYNOPSIS

     MERGE FILE ifile INTO SUBTREE tree-name

     [FAILURES TO FILE=filename]


Arguments

ifile

The name of an interim file that contains a directory and its
contents, or a hierarchy of directories and their contents.


tree-name

The name of the topmost directory in the subtree.
                                                           
filename

The name of a file that contains names that could not be merged.

Description

This command merges the contents of an interim file that has been
created using the dump subtree command into an existing subtree
whose top directory is specified in tree-name. If the target tree-
name does not exist, the command returns an error and the user must
use the create directory command to create it. The failures to file
= filename argument specifies a file name to contain the names that
could not be merged.

ACCESS RIGHTS
You must have control and write access to the directory you specify
as well as the contents of the directory.

3  example
The following command merges the interim file sth.dat with the .pjl
directory.

dns> merge file sth.dat into subtree .pjl

2  subtree
Dumps a directory or subtree and its contents into an interim file
and then merges the contents of that file into an existing subtree.
This command is useful when all clearinghouses are available for 
every directory in both subtrees and when no duplicate names exist 
in source and target directories.

SYNOPSIS

     MERGE SUBTREE old-tree-name[...] INTO SUBTREE

     new-tree-name [EXCLUDE entry-type]

Arguments


old-tree-name

The name of the topmost directory in the subtree that is being
changed. When used without the optional recursion notation (...),
only the specified directory and its contents are merged. The
recursion notation additionally causes all child directories (and
their contents) to merge into the target subtree.


new-tree-name

The name of the topmost directory in the target subtree.

entry-type

One or more of the following types of entries to exclude from the
change: objects, links, or directories. Multiple directories can be
excluded in a single command. Use any combination of the following
entry-type specifiers, separating multiple arguments with commas:

objects
links
directory directory name

Description

This command dumps a subtree into an interim file and then merges
the contents of that file into an existing subtree. Use the
recursion flag (...) to merge an entire subtree and its contents.
If you do not use the recursion flag, only the specified directory
and its contents are dumped and merged into the target subtree.

This command is useful when all clearinghouses are available for
every directory in both subtrees and when no duplicate names exist
in source and target directories. If a duplicate name is detected,
or if any affected clearinghouse cannot be reached while the merge
subtree command is in progress, the command completes what it can.
In this situation, a named interim file or failures file with a
randomly generated name is created in the current directory. The
directory new-tree-name must already exist. If it does not, the
command returns an error and you must use the create directory or
recreate directory command to create it.

ACCESS RIGHTS
You must have control and write access to the directory you specify
as well as the contents of the directory. If you use the command
recursively, you also need control and write access to all child
directories (and their contents) of the directory you specify.
                                                                  
3  example
The following command merges the contents of the .sth directory with
the .pjl directory.

dns> merge subtree .sth into subtree .pjl