home *** CD-ROM | disk | FTP | other *** search
/ Shareware Supreme Volume 6 #1 / swsii.zip / swsii / 165 / CHKFRG14.ZIP / CHKFRAG.DOC < prev    next >
Text File  |  1991-12-16  |  4KB  |  67 lines
  1. CHKFRAG
  2.  
  3. Bob Flanders and Michael Holmes                   August, 1989 (Utilities)
  4. Current version: 1.4 - December 16, 1991
  5.  
  6. Purpose:   To report, on-screen, the extent of file fragmentation on a hard
  7.            disk, and provide an ERRORLEVEL value usable within a batch file
  8.            to call a defragmenting program.
  9.  
  10. Format:    CHKFRAG [d:] [/% | /N | /E | /F] [/L] [/4]
  11.  
  12. Remarks:   Executed without any of its optional parameters, CHKFRAG
  13.            produces a screen report indicating the number of files and
  14.            directories, how many and what percentage of these are
  15.            fragmented, and how many extra (non- contiguously stored) parts
  16.            of files are contained on the currently-logged drive.  An
  17.            ERRORLEVEL code from 0-100, reflecting the percentage of
  18.            fragmented files, (the /% parameter is the default) is also
  19.            shown.
  20.  
  21.            An alternative drive (d:) to be analyzed may be specified, as
  22.            may be ERRORLEVEL return codes that reflect the actual number of
  23.            fragmented files (the /N parameter), the number of contiguous
  24.            free areas on the disk or of extra sections (the /E parameter).
  25.            The ERRORLEVEL return codes are not intended for strict
  26.            accuracy:  if any file is fragmented the minimum ERRORLEVEL
  27.            returned by the /% parameter is 1%, and 254 is the maximum
  28.            ERRORLEVEL returned by the /N and /E switch options.  These
  29.            return codes are intended to be used to trigger automatic
  30.            loading and execution of the user's defragmenting utility from
  31.            within a batch file.  An ERRORLEVEL return code of 255 is used
  32.            to indicate an error condition, which halts operation.
  33.  
  34.            If desired, a list of the names of fragmented files and
  35.            directories can be produced by specifying the optional /L
  36.            parameter.  The normal screen output from CHKFRAG may be
  37.            redirected to a file or to a printer, for easier analysis.
  38.  
  39.            If you are using DOS 3.31 (or any version of DOS before 4.x that
  40.            used 32 bit sector numbers for large hard disks), the /4
  41.            parameter will cause CHKFRAG to use a the DOS 4.x interface for
  42.            large drives.
  43.  
  44.            The DOS CHKDSK command, specified with its /F switch, should be
  45.            executed before running CHKFRAG; lost clusters or cross-linked
  46.            files are interpreted by CHKFRAG as a error condition.  Drives
  47.            created with the DOS ASSIGN or SUBST commands, and directories
  48.            created by JOIN, are not checked by CHKFRAG.  While analyzing
  49.            large disks, the utility requires approximately 100KB of
  50.            available RAM.  On-screen recommendations are to consider using
  51.            a defragmenting utility when file fragmentation is in the range
  52.            from 11% to 75%, and definitely to defragment disks that show
  53.            more than 75% fragmentation.
  54.  
  55.            CHKFRAG.EXE was written in the C language and its source code
  56.            should be compiled using the Microsoft C Compiler, Version 5.1
  57.            or later.
  58.  
  59.            Compile as follows:
  60.  
  61.                 CL /AL CHKFRAG.C
  62.  
  63. Notes:     If CHKFRAG is used within a batch job, the "/%" parameter must
  64.            be specified as "/%%".  This is necessarcy because the DOS batch
  65.            interpreter uses the percent (%) character to indicate where
  66.            replaceable parameters are to be inserted in the command line.
  67.