home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / ZSYS / ZSYSARK / SUSDSK01.ARK / Z3HELP20.LBR / CONCAT.HZP / CONCAT.HLP
Text File  |  1990-03-06  |  4KB  |  93 lines
  1. ;
  2.                                  CONCAT.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                3k (23)   FBFB  0.6        Gene Pizzetta 12/03      Z3COM3
  6.  
  7.   1- Syntax/Options  2- Notes                                                 
  8.  
  9.  
  10.  
  11.    CONCAT concatenates  two or  more  source  files into  a  destination file, 
  12. similar to PIP.   Unlike PIP, however,  CONCAT allows both named directory and
  13. drive/user specifications,  which allows elaborate  concatenations  with input
  14. files pulled from various drives and user areas.   For ZCPR3 only.
  15. :1
  16.   Syntax   CONCAT {dir:}outfile={dir:}infile{,{dir:}infile{, ...}} {/option}
  17.  
  18.    Any file without a DU or DIR spec is assumed to be on the current du:.  The 
  19. default is text file mode, checking for a CP/M end-of-file character (^Z).   
  20.  
  21.   Options     O - Object  file  mode  (CONCAT  ignores  ^Z  characters).   The
  22.                   default is text file mode, checking for ^Z (the CP/M end-of-
  23.                   file character).   Object file mode is provided because some
  24.                   hard-disk backup programs  can split large files  across two
  25.                   or more floppy disks. 
  26.  
  27.               Q - Toggle quiet mode.   Normally CONCAT prints the name  of the
  28.                   output file on the screen,  and then the name of each source
  29.                   file as it is read.   If a configuration byte at 111h is set 
  30.                   to a non-zero value, CONCAT will default to quiet operation,
  31.                   printing only error messages.   The Q option toggles  opera-
  32.                   tion to the non-default  mode.   Regardless of the  state of 
  33.                   the configuration byte, CONCAT defaults to quiet mode if the
  34.                   ZCPR3 quiet flag is  set.   In that  case  the Q option will
  35.                   likewise toggle to the non-default (verbose) mode.  
  36.  Syntax/Options - 2/3 
  37.  
  38.    CONCAT requires an output file and at least one source file.   Actually, it 
  39. can be used as  a simple file-copy utility,  but that's not its purpose.   The 
  40. same filename may be given  repeatedly in the source file list.  An equal sign 
  41. separates the output  file from the source files.   Commas or spaces, or both,
  42. separate multiple source files.
  43.  
  44.    While the equal sign is required, it may be separated from the filenames by
  45. one or more spaces.  The same applies to commas, if they are used; i.e, 
  46.  
  47.      concat newfile.txt=file1.txt,file2.txt,file3.txt,file4,txt
  48. works the same as
  49.      concat newfile.txt = file1.txt, file2.txt ,file3.txt , file4.txt
  50. which works the same as
  51.      concat newfile.txt = file1.txt file2.txt file3.txt, file4.txt
  52.  
  53.    A filename cannot begin with  a slash unless it  is preceded by a DU or DIR 
  54. specification; otherwise, CONCAT will think it has found an option list.
  55.  Syntax/Options - 3/3 
  56.  
  57.    If an error occurs, such as a source file not found,  the incomplete output 
  58. file is erased and the ZCPR3 error flag is set.  The error flag values are set
  59. as follows:
  60.  
  61.    0 = ambiguous filename (output or source)
  62.   10 = source file not found or not given in command line
  63.   11 = disk or directory full (write error)
  64.    4 = all other errors
  65.  
  66.    If another file has the same name as the output file, it will be renamed to
  67. filetype BAK.   CONCAT initially creates the  output file  with  a filetype of 
  68. $$$.   Any existing BAK is  erased,  the new BAK file created,  and the output 
  69. file renamed to the correct filetype after the copy is successfully completed.
  70.  
  71.    An invalid option (anything other than "O") will be ignored.
  72.  
  73.    CONCAT is re-entrant for use with the GO command.
  74. :2
  75.  
  76.  CONCAT Notes 
  77.  
  78.    a. Version 0.6 updates (12/3/89):
  79.       - minor changes for setting error flag.
  80.       - corrects serious error in detecting top of memory.
  81.  
  82.    b. Version 0.5 updates (11/25/89):
  83.       - adds quiet option and error flag support.
  84.       - fixes parser bug that allowed a null output filename.
  85.       - now closes output file on error before erasing it.
  86.  
  87.    c. Version 0.4 updates (11/12/89):
  88.       - adds large output buffer.  
  89.       - corrects error in parsing filespec in current user.
  90.       - commas no longer required in command line syntax.
  91.  
  92.    d. Version 0.3 updates (9/19/89):
  93.       - First preliminary release.