Dumps a subtree into an interim file.

 SYNOPSIS

      DUMP SUBTREE tree-name[...] INTO FILE filename

      [EXCLUDE entry-type]

 Arguments

 tree-name

 The name of the topmost directory in the subtree. When used without
 the optional recursion notation, the dump applies only to the
 specified directory and its contents. The recursion notation causes
 the command to additionally dump all child directories and their
 contents.

 filename

 The name of the interim file to which the subtree is dumped.

 entry-type

 One or more of the following types of entries to exclude from the
 dump: objects, links, or specific 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 directory and its contents into an interim
 file. Use the optional recursion flag (...) to additionally dump
 all child directories and their contents. Use the optional exclude
 argument to omit links, objects, or specific directories from
 the dump file. Use the file name extension .dat as a convention
 for interim file names. This command is useful for backing up a
 directory or as the first step of the merging directories procedure.

 ACCESS RIGHTS
 You must have read access to the specified directory and its
 contents. If you use the command recursively, you also need
 read access to all child directories (and their contents) of the
 directory you specify.

1  –  example

 The following command creates an interim file named pjl.dat that
 contains the .pjl directory and its contents.

 dns> dump subtree .pjl into file pjl.dat