                      -------------- ANALYZER ------------
                                  VERSION 01.00
                      COPYRIGHT (C) 1988 BY MICHAEL BAILEY
                               ALL RIGHTS RESERVED.
                      ------------------------------------

ANALYZER is a software program that will analyze floppy or hard disks and make
accurate disk  efficiency and performance ratings  based  on  several criteria
obtained from the disk itself.  This program may be used with DISKOP Hard Disk
Optimizer in order to determine whether or not data should be optimized and/or
disks reinitialized based on the disk drive performance tests that the program
invokes.

ANALYZER is rated for use under TRSDOS 6.x and may be used to analyze LDOS 5.x
TRSDOS 6.x and LSDOS 6.3 formatted floppy/hard drives.

THIS PROGRAM IS BEING RELEASED TO THE PUBLIC DOMAIN AND MAY BE COPIED AND USED
FREELY SO LONG AS IT IS MADE AVAILABLE AT NO CHARGE!

ANALYZER is a breeze to use. Simply type  ANALYZER <ENTER>  from the DOS ready
prompt and follow the instructions.   ANALYZER  works with all types of drives
regardless of capacity.


Some terms that you should be aquainted with beforehand...

On the ANALYZER display screen there are several abbreviated terms which are
intentionally shortened.  Their descriptions follow.

FILENAME EXT : This is the filename and (if any) extent on the disk.

FRAGMENTED   : Fragmentation.  This is an  exact number which indicates the 
               percentage of file fragmentation (for each file).   A ".00 %"
               would specify NO fragmentation, hence the file is contiguous.
               A "73 %" would indicate 73-percent of the file is fragmented.

OPTIMIZED    : The number in this column is the  exact percentage indicating
               the optimized portion of the file.   This figure is inversely
               proportional  to the Fragmented percentage of the file.

FILE SIZE    : This is the true file size for each file analyzed.

STCYL        : Starting Cylinder. This is the cylinder number where the file
               begins (where the file is initially located on the disk)

CONTIGUOUS   : This refers to granules  (areas on disk) which are in logical
               order. Simply put, this refers to files which are "clustered"
               together on the disk in a similar  area  as  opposed to files
               which are spread out over the disk in differing areas.


ANALYZER will display disk statistics for  each  optimizable file on the disk.
You may use the space bar to page through the analyzer's results and press the
BREAK key at any time to exit the program.  ANALYZER does not write to disk or
alter any files in any way.


TOTAL DISK STATISTICS

The very last screen will display the total drive statistics for the following
categories:

CONTIGUOUS DISK OPTIMIZATION  - This number represents the  total optimization
of the disk.   Simply stated,  it displays the percentage of the disk which is
contiguous (non-fragmented).

CUMULATIVE FILE OPTIMIZATION  - This number represents the  total optimization
factor of all *fragmented* files.   This might be confusing, but just remember
that this means "The Percentage of the fragmented file that is contiguous" You
might be wondering how fragmented files can be contiguous.  All files are only
fragmented or contiguous by a certain amount.  So to keep it from becoming too
technical, remember that CUMULATIVE FILE OPTIMIZATION refers to the percentage
of all *fragmented* files which are somewhat contiguous.

CONTIGUOUS DISK FRAGMENTATION - This number is the inverse of  CONTIGUOUS DISK
OPTIMIZATION shown above.  It displays the percentage of the disk which is not
contiguous, but fragmented over the surface.

CUMULATIVE FILE FRAGMENTATION - This number is the inverse of  CUMULATIVE FILE
Optimization shown above. It represents the total percentage of all fragmented
files and to what degree they are fragmented on the disk.


-------------------------------- TECHNICAL NOTES -----------------------------

ANALYZER determines the actual amount and percentage of file/disk optimization
and fragmentation  via a series of highly complicated mathematical algorithyms
some of which I will quickly outline below.

First of all, ANALYZER determines the format of the disk drive, number of sec-
tors per granule, and the number of granules per cylinder.

DETERMINING FRAGMENTATION...  The program first looks at each file on the disk
and determines  the  number  of granules being used in the first extent of the
file.   It  determines  the  total file size and uses the following formula to
calculate the fragmentation:

       ( 1 - ( GRANULES / TOTAL_NUMBER_OF_GRANULES_IN_FILE ) ) * 100

This formula provides the correct percentage of  fragmentation  in that file.
Only the granules located in the  first extent  of the file are considered to
be contiguous while the remaining extents (however many there may be) are the
fragmented portion of the file.   Using this method an accurate determination
of the percentage of the file which is fragmented may be calculated.  Finding
out the contiguous portion of the file is already done (GRANULES contains the
contiguous portion). Files with only 1 extent are considered to be contiguous
as their entire contents are located on specific area of the disk.  Note that
while files may, and sometimes must, have several extents, their optimization
factor may be improved simply by moving most of the file  to the first extent
while allocating the smaller portions of the file into the successive extents
thereby making most of the file contiguous.   This decreases fragmentation of
the file dramatically.  However, in most cases all of the uneccessary extents
can be removed through disk optimization, and small files (under 130K) can be
successfully reduced to contain only 1 extent!

CUMULATIVE FILE & DISK FRAGMENTATION AND OPTIMIZATION... As it was previously
stated above, this refers to  ALL  *Fragmented* files on the disk  and  their
total fragmentation vs optimization percentages.   Do  not  confuse this with
the total cumulative disk and file fragmentation and optimization sums of all
the files on the disk!  This term refers only to those files which are indeed
fragmented.  I included this calculation in order to determine  from  all the
fragmented files, what percentage of all the fragmented files were fragmented
and what percentage of them were optimized (contiguous).   This allows you to
make before and after comparisons to  determine the percent of  fragmentation
and optimization both before and after disk optimization.   Now, doesn't that
make sense?  Now if this is beginning to sound like a tongue twister then  I,
as a programmer, know that I'm doing my job correctly.  So this will conclude
my short technical discussion about the optimizer and optimization in general
so until next time...  If you have any questions or comments please send them
to me via any of the addresses listed below.

-------------------------END OF SHORT TECHNICAL DISCUSSION -------------------


I hope that you enjoy this program and will use it and pass it  along to other
Model 4 owners in your area.  Your  comments  and questions about this program
are welcomed and may be addressed to any of the numbers listed below.   Thanks
to those individuals who have supported DISKOP!

                   Mike Bailey
                   620 11th St.
                   Ramona, CA 92065

For the latest version of  ANALYZER and DISKOP,  you  may  call any of these
file bulletin board systems listed below.

                   S.D. METRO TBBS   (619) 582-5656 (also under Fido 10/210)
                   8-BIT TANDY       (619) 571-xxxx (300/1200  Baud Support)
                   GUY OMER'S 8N1 #1 (904) 377-1200 (with 2400 Baud Support)

                   All 24 Hours, 300/1200 BAUD 7 days a week.
