NAME

     apend  - append one data set to another

SYNOPSIS

     apend [ -Nntap ] [ -Ootap ] [ -R ] [ -V ] [ -? ]

DESCRIPTION

     apend puts the records contained in file ntap and puts  them
     at the end of the file otap.  This is done on a record basis
     and the traces/record, samples/trace, etc, are assumed to be
     the same for the two data sets.  This program is very useful
     in script files where multiple passes (e.g. do - done loops)
     are  made  on  data and the results collected together seri-
     ally.

     For example, the following script illustrates the point...


     #
             editt -Nindata -Oeddata -rs10 -re10
     for i in freq*
     do
             dctvf -Neddata -f$i  -Ooutdata.$i
             apend -Noutdata.$i  -Ofinal_out
     done

     Here editt is first used to pick off a portion of the  data.
     Then  for  each  file  starting  with  the characters "freq"
     (these files would contain dafd filter parameters) the  dafd
     program  dctvf is executed producing an output file with the
     frequency file name with the  name  of  the  frequency  file
     appended  to it. The data in this file is the put at the end
     of the file called "final_out", which will continue to  grow
     with  each  cycle  of  the loop. Note that on the first pass
     when there is actually no -O data set one  will  be  created
     and the contents of the -N data set placed in it.

     NOTE:  It  is  very  important  that  the  both  number   of
     trace/record  (NumTrc)  and  the  number of records (NumRec)
     entries be correct in the line headers of both the input and
     output  (if  it exists). If either of these is incorrect the
     program may appear to have worked but in  fact  will  output
     strange  data  on  disk that you cannot scan properly. apend
     uses these two entries to properly position the  pointer  at
     the end of the current output data set ready for writing the
     input data.

     apend gets both its data and  its  parameters  from  command
     line  arguments.  These arguments specify the input, output,
     and verbose printout, if desired.


  Command line arguments
     -N ntap
          Enter the input data set name or file immediately after
          typing -N.  Default = stdin (pipe in).  This input file
          should include the  complete  path  name  if  the  file
          resides    in    a    different   directory.    Example
          -N/b/vsp/dummy tells  the  program  to  look  for  file
          'dummy' in directory 'vsp' stored on the 'b' disk.

     -O otap
          Enter the output data  set  name  or  file  immediately
          after  typing -O.  This output file must not be a pipe.
          The output data set also requires the  full  path  name
          (see above).

     -R   Enter the command line argument '-R'  to  renumber  the
          output  records  (trace  header 106).  Otherwise record
          numbers of the input data set will be preserved.

     -V   Enter the command line argument '-V' to get  additional
          printout.

     -?   Enter the command line  argument  '-?'  to  get  online
          help.   The program terminates after the help screen is
          printed.

COPYRIGHT

     copyright 2001, Amoco Production Company
               All Rights Reserved
          an affiliate of BP America Inc.