;
                                  CRCBLD.COM                                  

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               3k (18)   04D5  1.4        Gene Pizzetta 9/91       Z3COM3

  1- Syntax  2- Configuration  3- Errors  4- Notes                            


   CRCBLD is a ZCPR3 utility that writes a  SIG/M-type  catalog  and CRC file.
Based on SIG/M's  CRCBUILD  program,  this version  works in any drive or user
and obtains the disk number automatically from the disk  label,  if one exists
in the target directory.
:1
 Syntax   CRCBLD {dir:}{afn.aft}

   If no DIR or DU specification is given,  the current  directory is assumed.
If no filename is given, CRCBLD defaults to all files ("*.*").

   If a disk label exists in the target directory,  the disk  number  from the
filetype area of that label will be used as the  volume number.   If  no  disk
label is found,  or if the filetype of the label is  non-numeric,  CRCBLD will
prompt for a three-digit number.
 Catalog File - 1/2 

   The catalog file (-CATALOG.nnn, where "nnn" is the disk number) is  written
in the target directory.   Each line of the  catalog  file  includes  the disk
volume number, the sequence number of the file, the filename and filetype, the
file's size in kilobytes, and the file's CRC (cyclic redundancy checksum based
on the CCITT standard polynominal:  X^16 + X^15 + X^13 + X^7 + X^4 + X^2 + X +
1.  For example:

     456.01	INTEL   .MAC    9K   5E 6C
     456.02	TEST    .Z80    1K   62 25
     456.03	TVI-CHAR.MAC    2K   FB 32
     456.04	TVI-CSET.Z80    1K   28 E7
     456.05	WS4-TV65.MAC    6K   70 33
     Archival Libraries Volume 456 -- 05 Files Cataloged.

   The final line of the file includes a summary  message  ("Archival  Librar-
ies", above), the volume number, and the number of matching files found.

   The format of the catalog file is compatible with the  CRCZ utility,  which
can be used to automatically validate the CRC's of the files on the disk.
 Catalog File - 2/2 

   The area on each line beyond the CRC is available for comments, if desired,
which can be added with any ASCII text editor:

     456.01	INTEL   .MAC    9K   5E 6C  Extended Intel test file
     456.02	TEST    .Z80    1K   62 25  Zilog test file
     456.03	TVI-CHAR.MAC    2K   FB 32  Creates new TVI character
     456.04	TVI-CSET.Z80    1K   28 E7  Displays TVI character set
     456.05	WS4-TV65.MAC    6K   70 33  TVI patch file for WordStar 4
     Archival Libraries Volume 456 -- 05 Files Cataloged.

   DateStamper !!!TIME&.DAT files  are ignored,  as are temporary files with a
dollar sign in their filetype.   Whether system files are included  or ignored
is a configurable option.  As distributed, CRCBLD includes system files.
:2
 Configuration 

  The tag character for your disk labels and whether CRCBLD finds system files
are  configurable  options that can be set  using  ZCNFG  and the accompanying
CRCBLDnn.CFG file.

   The summary message ("Archival Libraries" in the example above) can also be
set to anything your heart desires, up to 30 characters.  This message must be
changed using a file patching utility,  such as ZPATCH.   The patch area is in
the first of the CRCBLD.COM file and is delimited by "-->"  and "<--" markers.
The string must be terminated by a null character (binary zero).
:3
 Errors 

   The program error flag will be set on exit to standard error codes as found
in Z34ERR.LIB.  On error, the error handler will also be invoked.
:4
 Notes 

   a. Vs 1.4 updates (09/30/91, Gene Pizzetta):
      - Made summary message configurable.  
      - Did a lot of code tweeking.  
      - Now sets program error flag and invokes error handler on error.  
      - Added documentation file.  
      - Minor changes to configuration file.

   b. Vs 1.3 updates (04/06/91, Gene Pizzetta):
      - Now accepts DU spec for target directory.  
      - Looks for disk label with number in  filetype.   If disk label exists,
        number from its filetype is used.   If no  disk label is  found,  asks
        user for disk number.  
      - Converted from absolute to linked  assembly,  and from  Intel to Zilog
        mnemonics.  
      - Added library routines.  
      - Added internal editor and tab expansion.  
      - Now uses BIOS for console I/O.  
      - Eliminated much redundant and unused code.  
      - Tag character for disk  label  and  whether  system  files  should  be
        included are configurable with ZCNFG. 
 Notes - 2/ 

      - Program name changed to CRCBLD from CRCBUILD.  
      - DateStamper TIME&.DAT files are now ignored.

   c. Vs 1.2 updates (03/31/90, Gene Pizzetta):
      - Modified to ignore system files.  
      - File size routine now handles files larger than 255K.  
      - This version runs only on Z80 or compatible machine.

   d. Vs 1.1 updates (04/15/89, Gene Pizzetta):
      - Modified messages for achival libraries.

   e. Vs 1.0 (04/08/83, John L. Raff WB2MDG/KAPP8107):
      - A program to build a CP/M file in  SIG/M  -CATALOG format and  print a
        cyclic-redundancy check number based on the  CCITT  standard  polynom-
        inal: X^16 + X^15 + X^13 + X^7 + X^4 + X^2 + X + 1

