[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[ DISKTOOL ]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]
[[                                                                           ]]
[[    DISKTOOL is copyrighted 1988 by Michael Bailey. All Rights Reserved.   ]]
[[ For use under TRSDOS 6.x - LSDOS 6.3 / Use on LDOS 5.x & TRSDOS 6.x disks ]]
[[                    This is version 01.00 of DISKTOOL                      ]]
[[                                                                           ]]
[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]



REQUIREMENTS,
             .................DISKTOOL runs under TRSDOS 6.x and can be used
to analyze and modify LDOS 5.x, TRSDOS 6.x, and LSDOS 6.3 diskettes. Minimum
64K 1-disk required  but maximum benefit is obtained through use of DISKTOOL
on double-sided disk drives and hard drives.  DISKTOOL  may be used with any
hard drive system and any floppy drive system with exception of 3.5 disks. I
have not tested it with 3.5"  drives  but  you may wish to try it.  DISKTOOL
may be used with 5- or 8-inch single- or double-sided  SDEN/DDEN floppy disk
drives.  DISKTOOL's most unique feature is it's ability to display the free-
space map of your  disk drive  and pinpoit the exact locations of disk files
theirein.  Because of the unique display methods incorporated in the program
DISKTOOL at present cannot correctly  display the map of drives which exceed
306 physical cylinders (per logical drive) or 10 Megabyte (8K Grans) per any
logical drive...       Since I am unable to accurately estimate the need for
such diverse software configurations,  I  will  extend the program's current
hardware  capabilities  only  if  I  receive  some  requests from interested
parties.  Please supply your logical/physical hardware spec's.


INTRODUCTION,
             DISKTOOL will permit you to move files from a disk drive to any
other cylinder on any other disk drive.  You  can  now have complete control
over files and manipulate their placement on almost any size drive with only
a few keystrokes using this program.


USING DISKTOOL,
               From DOS Ready, type DISKTOOL and press enter.   Within a few
moments you will see the opening banner and then  prompted to enter a number
between 0-7, which corresponds to a disk drive on your system.  After you've
entered the drive number,  you  will  be  presented with a screen that looks
like this:


Filename/Ext:  DISKTOOL/CMD   Starting Cylinder:  32          Drive Size: 5"   
Mod Date    :  11/12/88       Starting Granule :  3           Drive Type: Hard 
Mod Time    :  --------       Total File Size  :  8,291          Density: Rigid
Protection  :  Full           Number of Extents:  3            Attribute: Fixed
Modification:  None           % Optimized      :  43.00 %          Sides: 0    
Attribute 1 :  Invisible      % Fragmented     :  67.00 %          Heads: 1    
Attribute 2 :  None           EOF Offset Byte  :  255          Cylinders: 306  
L Rec Length:  256            File Linked > DEC:  255        Sectors/Cyl:  64  
                                                                               
Drive :5   Name: BACKUPS    Date: 02/19/88   Free Space:  1288.00K / 2448.00K  
=============================================================================
000-013 x... xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx
014-027 xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx
028-041 xxxx xxxx xxxx xxxx xx## #### xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx
042-055 xxxx xxxx xxxx xxxx xxx. ..xx xxxx xxxx xxxx xxxx #### #### xx## xxxx
056-069 xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx ...x xxxx xxxx
070-083 xxxx xxxx xxxx xxxx .... .... DDDD .... .... .... .... .... .... ....
084-097 .... .... .... .... .... .... .... .... .... .... .... .... .... ....
098-111 .... .... .... .... .... .... .... .... .... .... .... .... .... ....
112-125 .... .... .... .... .... .... .... .... .... .... .... .... .... ....
126-139 .... .... .... .... .... .... .... .... .... .... .... .... .... ....
140-153 .... .... .... .... .... .... .... .... .... .... .... .... ....     
=============================================================================
<C>opy  <M>ove  <K>ill  <S>earch  <L>ogin  <P>age  <A>nalyze  <O>ptimize  <?>


The screen contains information about the first  file entry in the directory
as well as technical information about the drive itself.  The free-space map
shows what the drive looks like.  The  "x"  denotes granules which are being
used and the   "#"  denotes where the current file is located on that drive.
The "#" represented here is a graphics character in the actual program.  You
can now find out where exactly files are located on any disk easily. Use the
LEFT and RIGHT arrow keys to scroll through the directory.  Press any of the
following keys to perform a specific function:

<C>opy File  -  Pressing C will copy the current file to any other drive you
have defined.  You will be prompted for the destination drive.  If you spec-
fy the currently active drive, you will be prompted for a filename.   TRSDOS
and other Model 4 DOS's  do not allow you to have two files on one disk with
the same filename.

<M>ove File  - This function will move the currently active file highlighted
in the upper left-hand corner to any specific cylinder on the current drive.
MOVE allows you to individually optimize and manipulate file placement.  You
must use caution when using this command.  Do *not*  Move a file if the disk
does not have enough free space!  To determine the amount of free space that
is required, take the file size and multiply it by two.  If this figure exc-
eeds the total amount of free space available, then you cannot move it.   If
you attempt to  Move a file whose total size multiplied by two  exceeds free
space available on the currently active disk, YOU WILL LOSE THAT FILE!   You
may use the  <C>opy and  <K>ill commands to Move any file around on the disk
if you are unsure whether or not there is adaquete free space available.    
This is by far the safest way to move files.  Note:  You may only MOVE files
to and from the currently active drive.

<K>ill File  -  Pressing K will remove the currently highlighted file.   You
will be prompted with  "Remove This File? (Y/N): _"   Pressing Y will delete
the file from the disk, and any other key will abort.

<S>earch for File  - Pressing this key will find a file on the drive quickly
without having to scroll through several filenames. You will be prompted for
the filename/ext.  Enter all or part of the filename.

<L>ogin Drive  -  Pressing D  will log in another drive.  To  change between
drive :1 and drive :2 for example, you would type L followed by 2.

<P>age Two  -  This feature has not yet been implemented.  It's function was
originally intended to provide those users whose disk  configuration exceeds
306 cylinders and/or 10 Megs (per any logical drive).  I will add this feat-
ure if I receive some requests from interested individuals but at this  time
it is just too difficult to implement without  knowing  whether or not there
are an even number of people using this type of drive configuration.

<A>nalyze Drive - Analyze the entire drive and determine  it's  optimization
(disk) and fragmentation (file) percentages and display these figures.  I've
improved upon the optimization/fragmentation formula and  have included this
feature with this program.

<O>ptimize Drive - Loads DISKOP/CMD if it is available on any of your drives
or it will display an error message if it is not available  and then exit to
DOS ready.

<BREAK> Pressing BREAK at any time  will exit the program and  return you to
DOS Ready.

----------------------------------------------------------------------------
SPECIAL NOTE:   The display (called Windowed Menu ) shown above contains the
free-space map for the currently active drive. This map is somewhat crunched
and  as  such it will only display free-space information for logical drives
not exceeding 306 physical cylinders  AND  if the logical drive is formatted
under 10 Megabytes.  If  you are  using a drive which has been formatted and
contains more than 10 meg, then please let me know  via any of the addresses
shown at the bottom of this file.  I would like to know how many people have
or are using a drive configured in excess of 306 cylinders  (LOGICAL DRIVE!)
or ten megabyte partitions.   I will extend this program if enough users are
interested and who can not make use of this program in it's present form.   
----------------------------------------------------------------------------

This program is still in it's infancy  stages and I'd like to expand upon it
as much as possible.  Please send any questions, comments, questions, ideas,
or criticisms to...

                      MICHAEL BAILEY
                      620 11TH ST.
                      RAMONA, CA 92065

Or call...
                        SD METRO BBS @ (619) 582-5656 ( 300/1200 BAUD )
                        8-BIT TANDY  @ (619) 571-6366 ( 300/1200 BAUD )
                   YOUR FAVORITE BBS @ Send Netmail   ( FidoNet 10/210)


Try these fine bulletin board systems...

                        GUY'S 8N1 #1 @ (904) 377-1200 ( 300/1200/2400 )
                        TBBS ISLAND  @ (303) 690-9423 ( 300/1200 BAUD )

OLYMPICS '88!
