1 10/20/86  merge_list, mls
 2 
 3 
 4 Syntax as a command:  mls mas_path up_path {out_path} {-control_args}
 5 
 6 
 7 Function:  combines two lister files into a single lister file.
 8 
 9 
10 Arguments:
11 mas_path
12    is the pathname of the master lister file.  The suffix lister must
13    be the last component of the lister file name; however, if mas_path
14    does not have a suffix of lister, one is assumed.
15 up_path
16    is the pathname of the update lister file.  The suffix lister must
17    be the last component of the lister file name; however, if up_path
18    does not have a suffix of lister, one is assumed.
19 out_path
20    is the pathname of the output lister file.  The suffix lister must
21    be the last component of the lister file name; however, if out_path
22    does not have a suffix of lister, one is assumed.  If this argument
23    is not specified, the master lister file is replaced.
24 
25 
26 Control arguments:
27 -field_name fn1 ...  fni, -fn fn1 ...  fni
28    specifies that fields fn1 through fni are used as the controlling
29    fields for the merge.  (Records can only be merged if they contain
30    the same fields, though some of those fields may be null.)  The
31    fields are compared without regard to case.  If this control
32    argument is not specified, then all fields are used to control the
33    merge.
34 -totals, -tt
35    displays the number of records in the master, update, and output
36    files.
37 
38 
39 Only one of the following control arguments can be specified.
40 -add
41    copies into the output lister file all records from the master
42    lister file plus all records from the update lister file.  Thus
43    records contained in both lister files are listed twice in the
44    output file.  (Default)
45 -and
46    copies into the output file those records in the master lister file
47    that are also in the update lister file.  That is, those records
48    that are listed in both files are listed once in the output file; no
49    records from the update lister file are copied.
50 
51 
52 -or
53    copies into the output lister file all records in either the master
54    lister file or the update lister file.  Duplicate records are copied
55    only from the update lister file and thus appear only once in the
56    output file.
57 -subtract, -sub
58    copies into the output lister file all records in the master lister
59    file that are not also contained in the update lister file.  Thus no
60    duplicate records are copied and no records from the update lister
61    file are copied.
62 
63 
64 Notes:  The merge_list command sets the "lister" severity indicator.  A
65 severity of 2 is set when the merge is not performed or the invocation
66 of merge_list terminates abnormally.  A severity of 0 is set when the
67 merge is successful and the command terminates normally.