;
                                 CONCAT.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               3k (23)   90D5  0.4        Gene Pizzetta 11/89      Z3COM3

  1- Syntax                                                                   



   CONCAT concatenates  two or  more  source  files into  a  destination file, 
similar to PIP.   Unlike PIP, however,  CONCAT allows both named directory and
drive/user specifications,  which allows elaborate  concatenations  with input
files pulled from various drives and user areas.   For ZCPR3 only.
:1
  Syntax   CONCAT {dir:}outfile={dir:}infile{,{dir:}infile{, ...}} {/option}

   Any file without a DU or DIR specification is assumed to  be on the current 
drive/user.   The default is text file mode, checking for  a CP/M  end-of-file 
character (^Z).   The only option  at present  is 'O',  which  puts  CONCAT in 
object file mode so ^Z's are ignored.

   CONCAT requires an output file and at  least one input file.   Actually, it 
can be used as  a simple file-copy utility,  but that's not its purpose.   The 
same filename may be given  repeatedly in the input file list.   An equal sign 
separates the output  file from  the input files.   Commas or spaces, or both,
separate multiple input files.

   While the equal sign is required, it may be separated from the filenames by
one or more spaces.  The same applies to commas, if they are used; i.e, 
     concat newfile.txt=file1.txt,file2.txt,file3.txt,file4,txt
works the same as
     concat newfile.txt = file1.txt, file2.txt ,file3.txt , file4.txt
which works the same as
     concat newfile.txt = file1.txt file2.txt file3.txt, file4.txt

   A filename cannot begin with  a slash unless it  is preceded by a DU or DIR 
specification; otherwise, CONCAT will think it has found an option list.

   If another file has the same name as the output file, it will be renamed to
filetype BAK.   CONCAT initially creates the  output file  with  a filetype of 
$$$.   Any existing BAK is  erased,  the new BAK file created,  and the output 
file renamed to the correct filetype after the copy is successfully completed.

   If an error occurs, such as an input file not found,  the incomplete output 
file is erased.

   An invalid option (anything other than "O") will be ignored.

   The quiet flag is  obeyed:  if they quiet flag is set,  only error messages
are displayed.

   CONCAT is completely re-entrant for use with the GO command.