;
                                 CONCAT.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               3k (23)   FBFB  0.6        Gene Pizzetta 12/03      Z3COM3

  1- Syntax/Options  2- Notes                                                 



   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 spec is assumed to be on the current du:.  The 
default is text file mode, checking for a CP/M end-of-file character (^Z).   

  Options     O - Object  file  mode  (CONCAT  ignores  ^Z  characters).   The
                  default is text file mode, checking for ^Z (the CP/M end-of-
                  file character).   Object file mode is provided because some
                  hard-disk backup programs  can split large files  across two
                  or more floppy disks. 

              Q - Toggle quiet mode.   Normally CONCAT prints the name  of the
                  output file on the screen,  and then the name of each source
                  file as it is read.   If a configuration byte at 111h is set 
                  to a non-zero value, CONCAT will default to quiet operation,
                  printing only error messages.   The Q option toggles  opera-
                  tion to the non-default  mode.   Regardless of the  state of 
                  the configuration byte, CONCAT defaults to quiet mode if the
                  ZCPR3 quiet flag is  set.   In that  case  the Q option will
                  likewise toggle to the non-default (verbose) mode.  
 Syntax/Options - 2/3 

   CONCAT requires an output file and at least one source 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 source file list.  An equal sign 
separates the output  file from the source files.   Commas or spaces, or both,
separate multiple source 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.
 Syntax/Options - 3/3 

   If an error occurs, such as a source file not found,  the incomplete output 
file is erased and the ZCPR3 error flag is set.  The error flag values are set
as follows:

   0 = ambiguous filename (output or source)
  10 = source file not found or not given in command line
  11 = disk or directory full (write error)
   4 = all other errors

   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.

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

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

 CONCAT Notes 

   a. Version 0.6 updates (12/3/89):
      - minor changes for setting error flag.
      - corrects serious error in detecting top of memory.

   b. Version 0.5 updates (11/25/89):
      - adds quiet option and error flag support.
      - fixes parser bug that allowed a null output filename.
      - now closes output file on error before erasing it.

   c. Version 0.4 updates (11/12/89):
      - adds large output buffer.  
      - corrects error in parsing filespec in current user.
      - commas no longer required in command line syntax.

   d. Version 0.3 updates (9/19/89):
      - First preliminary release.