DNS$CPHELP.HLB  —  merge

1  –  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
 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.

1.1  –  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.

2.1  –  example

 The following command merges the contents of the .sth directory with
 the .pjl directory.

 dns> merge subtree .sth into subtree .pjl
Close Help