ADD.DF

ADD.DF

Top  Previous  Next

 

The ADD.DF command adds a part file to a distributed file.

 

 

Format

 

ADD.DF dist.file  part.file  part.no {algorithm} {RELATIVE}

 

where

 

dist.fileis the name of the distributed file.

 

part.fileis the name of the part file to be added.

 

part.nois the part number associated with this part file.

 

algorithmis the name of the partitioning algorithm in the dictionary of part.file.

 

 

First use of the ADD.DF command will create the distributed file, compiling the partitioning algorithm and adding the named part file. The newly created distributed file will share the dictionary of the first part file. Subsequent use of the ADD.DF command will add further part files. The algorithm need not be specified for the second and subsequent parts and will be ignored if present.

 

If the part.file is stored in the same directory as dist.file or a subdirectory of it, the RELATIVE keyword causes the part.file pathname to be stored internally relative to that directory. This can simplify copying distributed files.

 

When creating a new distributed file, the dictionary reference in the VOC F-pointer created to define this file is copied from the VOC entry for part.file. Again, use of the RELATIVE keyword will create the VOC entry with a relative pathname for the dictionary if it is in the same directory as dist.file or a subdirectory of it.

 

Note that the partitioning algorithm is copied into the distributed file. Changing the expression in the dictionary will not have any effect. It will be necessary to reconstruct the distributed file.

 

 

Example

 

ADD.DF ORDERS ORDERS-08 8 PART.ALG

ADD.DF ORDERS ORDERS-09 9

 

This pair of commands creates a distributed file named ORDERS that consists of two parts, ORDERS-08 and ORDERS-09, perhaps corresponding to orders taken in a specific year. The part numbers are 8 and 9 respectively. The partitioning algorithm is named PART.ALG in the dictionary of ORDERS-08.

 

 

See also:

Distributed files, LIST.DF, REMOVE.DF