home *** CD-ROM | disk | FTP | other *** search
/ Between Heaven & Hell 2 / BetweenHeavenHell.cdr / util / dog.doc < prev    next >
Text File  |  1988-12-01  |  16KB  |  412 lines
  1.  
  2.  
  3.                   Disk OrGanizer - Version 2.05
  4.                         December 1, 1988
  5.  
  6.                        Soft GAM's Software
  7.                        G. Allen Morris III
  8.                          P. O. Box 1311
  9.                       Mendocino, CA  95460
  10.                          Copyright 1988
  11.  
  12.                      Compuserve: #73210,3374
  13.                          Source: BFH700
  14.                             BIX: gam3
  15.                          UUCP: gam3@well
  16.                       Voice: (707)961-1470
  17.  
  18.  
  19. TABLE OF CONTENTS
  20.  
  21. INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . .  1
  22.  
  23. SHAREWARE. . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  24.  
  25. RUNNING DISK ORGANIZER THE FIRST TIME. . . . . . . . . . . . .  2
  26.  
  27. RUNNING DISK ORGANIZER FROM THE COMMAND LINE . . . . . . . . .  4
  28.  
  29. RUNNING DISK ORGANIZER WITH AN ORDER FILE. . . . . . . . . . .  6
  30.       MODES. . . . . . . . . . . . . . . . . . . . . . . . . .  6
  31.       SWITCHES . . . . . . . . . . . . . . . . . . . . . . . .  6
  32.       COMMANDS . . . . . . . . . . . . . . . . . . . . . . . .  7
  33.       FILE-IDENTIFIERS . . . . . . . . . . . . . . . . . . . .  8
  34.       COMMENTS . . . . . . . . . . . . . . . . . . . . . . . .  8
  35.  
  36. SAMPLE ORDER FILE. . . . . . . . . . . . . . . . . . . . . . .  9
  37.  
  38. INDEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  39.  
  40.  
  41. INTRODUCTION
  42.  
  43.     A disk that has been in use a while will have fragmented
  44. files and directories; that is, some of its files and directories
  45. are no longer written in contiguous disk clusters, but are
  46. located wherever DOS was able to find available disk space.  This
  47. increases the time required to access any of that data, puts more
  48. wear on your disk drive's head actuator and increases the noise
  49. generated by the disk.
  50.  
  51.     Disk OrGanizer will help you speed up your disk access times
  52. by defragmenting files and removing deleted entries from dir-
  53. ectories.  It will also allow you to determine the order of files
  54. and subdirectories.  It can also free some disk space by truncat-
  55. ing subdirectories.  A nice side effect of this is that non-
  56. fragmented files are much easier to recover with the many un-
  57. erase programs available.
  58.  
  59.  
  60. SHAREWARE
  61.  
  62.     This is a shareware program.  This program is not in free;
  63. you may use this program for a 30 day trail period, if you wish
  64. to continue using this program after that time you must purchase
  65. a licence agreement.  The cost of a licence agreement for non-
  66. commercial use is on a sliding scale of $5.00 to $30.00,  for
  67. commercial use the cost is $30.00 for the first unit and $15.00
  68. for each additional unit.  Site licenses and commercial distribu-
  69. tion licenses are available.
  70.  
  71. Please make check payable in US dollars to:
  72.  
  73.     Soft GAM's Software
  74.     P. O. Box 1311
  75.     Mendocino, CA  95460
  76.  
  77. If you don't support shareware it will go away.
  78.  
  79.  
  80. RUNNING DISK ORGANIZER THE FIRST TIME
  81.  
  82.     Before you do anything else, back up your hard disk, and
  83. make copies of any floppy disks you want to organize.
  84.  
  85.     Disk OrGanizer has been tested with MSDOS 2.10, 3.01, 3.10
  86. and 3.30 on logical drives as large as 32 megabytes.  It is
  87. believed that Disk OrGanizer will operate on any MS/PCDOS DOS
  88. disk.  (DOS version 4.0 disks with 32 bit File Allocation Tables
  89. (FAT) are not supported at this time.)  Disk OrGanizer performs
  90. extensive tests before it starts to move data, to make sure that
  91. the FAT and directories are in good repair and verifies all data
  92. written to the disk.  
  93.  
  94.     Disk OrGanizer will not cause data loss in a power failure.
  95.  
  96. WARNING:  Power surges to the write head of the disk during a
  97. power failure could cause data loss.  (This is the case whenever
  98. any program is writing to the disk.)
  99.  
  100.     You can now test Disk OrGanizer by typing the command:
  101.  
  102.     DOG [d:] /TEST
  103.  
  104. [d:] is an optional drive specifier.  The current drive is the
  105. default.  (The []'s mean optional and should not be typed.)  If
  106. you do not receive any error messages from this command, you will
  107. be able to run Disk OrGanizer on the tested drive.  Be sure that
  108. you have a backup of your data before you continue.
  109.  
  110.     You can now run Disk OrGanizer and defragment all of the
  111. files on a drive by typing the command:
  112.  
  113.     DOG [d:] /FAST
  114.  
  115.     If you would also like to recover some disk space by trun-
  116. cating your subdirectories type the command:
  117.  
  118.     DOG [d:] /FAST /TRUNCATE
  119.  
  120. Please note that you may not have any directories with enough
  121. deleted files to allow truncation.
  122.  
  123.     Disk OrGanizer reads and tests the FAT and directories,
  124. gives you a report, tells you what it is going to do, and asks
  125. you if you wish it to organize the disk.  Nothing will be written
  126. to the disk until you answer yes to this question.
  127.  
  128.     You may abort from Disk OrGanizer at any time by typing an
  129. Esc or ^C (there may be a slight delay).  Aborting from Disk
  130. OrGanizer while it is moving clusters may cause extreme frag-
  131. mentation, rerun Disk OrGanizer as soon as possible if you abort
  132. while it is moving clusters.
  133.  
  134.     If you think that Disk OrGanizer has stopped running, press
  135. the space bar, you should then hear a beep within a minute.
  136.  
  137.     If you get error running Disk OrGanizer run CHKDSK with the
  138. F switch. (See your DOS manual.)
  139.  
  140.     if you get an "Out of memory error", try running Disk
  141. OrGanizer after removing any terminate and stay resident (TSR)
  142. programs, if this does not solve the problem try lowering the
  143. number of FILES and BUFFERS in your CONFIG.SYS file.  (Disk
  144. OrGanizer will run with FILES=6 and BUFFERS=1.)  If you still get
  145. the "Out of memory error" you will have to decrease the total
  146. number of files on the drive.
  147.  
  148.     The easiest way to do the above is to re-boot from a disk
  149. that has no CONFIG.SYS or AUTOEXEC.BAT files.
  150.  
  151.  
  152. RUNNING DISK ORGANIZER FROM THE COMMAND LINE
  153.  
  154.     For most applications DOG can simply be run from the command
  155. line or a batch file.  This chapter will tell you how to do this.
  156.  
  157.     The general format for running Disk Organizer from the DOS
  158. prompt is:
  159.  
  160.     DOG [d:] /mode [/TRUNCATE][/BATCH][/NOVERIFY]
  161.  
  162. (The []'s mean optional and should not be typed.)
  163.  
  164.     d: is an optional drive specifier.  The current drive is the
  165.      default. 
  166.  
  167.     mode is one of the following:
  168.  
  169.        /FAST mode will defragment all files and attempt to put
  170.                them in one area of disk space, FAST may leave
  171.                gaps of free space between files.  This is the
  172.                mode that should be used by most people.
  173.  
  174.     /FILL mode will defragment files and put them as close
  175.                to the FAT as possible, FILL will not leave any
  176.                free space between files.  FILL may leave files
  177.                fragmented around BAD disk sectors and unmovable
  178.                files.
  179.  
  180.        /DATE mode will put the files on the disk oldest files
  181.                first (closest to the FAT).  Using this mode once
  182.                in a while, it can take a long time to run, may
  183.                decrease the number of clusters that Disk
  184.                OrGanizer will need to move with the FAST or FILL
  185.                mode.
  186.  
  187.        /DIREctory mode will put the files on the disk in the
  188.                order in finds them in the directories.  That is
  189.                the first file or sub-directory in the root
  190.                directory will be closest to the FAT (also refer-
  191.                red to as first) followed by the second file in
  192.                the root, etc.  (See appendix B)
  193.         
  194.        /TRUNCATE is a switch telling Disk OrGanizer to truncate all
  195.                sub-directories.
  196.  
  197.        /BATCH is a switch telling Disk OrGanizer to suppress all
  198.                prompts.  If this switch is set any error will cause
  199.                Disk OrGanizer to return an error code (see Appendix A)
  200.                and terminate.  This is useful for running Disk
  201.                OrGanizer from a batch file. 
  202.  
  203.        /NOVERIFY is a switch telling Disk OrGanizer not to verify
  204.                data written to the disk.  This will increase the speed
  205.                of Disk OrGanizer but will allow data to be lost.  This
  206.                switch should not be used on a floppy disk, but may be
  207.                used on a hard disk at your own risk.  This is for
  208.                people to whom speed is more important than data
  209.                integrity.
  210.  
  211.  
  212. RUNNING DISK ORGANIZER WITH AN ORDER FILE
  213.  
  214.     If you would like to have more control over the location of
  215. files (a subdirectory is a special file) on your disk you can
  216. create an ORDER file.
  217.  
  218.     This file allows you move named files close to the FAT or
  219. away from the FAT, any files that are not named in this file are
  220. then placed between these two areas.
  221.  
  222.     The area of the disk close to the FAT is called the LOW area
  223. and the area away from the FAT is called the HIGH area.  Any file
  224. that is not named anywhere in the ORDER.DOG file is said to
  225. FLOAT.
  226.  
  227.     In making this file you should name as few files as
  228. possible.
  229.  
  230.     The command to run Disk OrGanizer with an ORDER file is:
  231.  
  232.     DOG [d:] [orderfile] [/mode] [/switch]
  233.  
  234.     d: is the optional drive.
  235.  
  236.     orderfile is the path and filename of the order file.  If
  237.      this is not included Disk OrGanizer will look for a file
  238.      called ORDER.DOG in the root directory of the drive being
  239.      organized and if it does not find that it will look in the
  240.      environment for 'DOG=d:\path\filename' and use that file.
  241.  
  242.  
  243. MODES
  244.  
  245.     You must include a mode.  The Mode only affects files not
  246. included in the ORDER file.  A mode given on the command line
  247. will override the mode in the ORDER file.
  248.  
  249.    [FAST] mode will defragment all files and attempt to put
  250.           them in one area of disk space, FAST may leave gaps of
  251.           free space between files.  This is the mode that should
  252.           be used by most people.
  253.  
  254.    [FILL] mode will defragment files and put them as close to
  255.           the FAT as possible, FILL will not leave any free space
  256.           between files.  FILL may leave files fragmented around
  257.           BAD disk sectors and non-moveable files.
  258.  
  259.    [DIREctory] mode will put the files on the disk in the order
  260.           in finds them in the directories.
  261.  
  262.    [DATE] mode will put the files on the disk oldest files
  263.           first.
  264.  
  265.  
  266. SWITCHES
  267.  
  268.     You may also set some of these switches from the command
  269. line.
  270.  
  271.    [TRUNCATE ALL] is a switch telling Disk OrGanizer to
  272.           truncate all subdirectories.  This is the same as the
  273.           command line TRUNCATE switch.
  274.  
  275.    [BATCH] is a switch telling Disk OrGanizer to suppress all
  276.           prompts.  If this switch is set any error will cause
  277.           Disk OrGanizer to return an error code and terminate.
  278.  
  279.    [NOVERIFY] is a switch telling Disk Organizer not to verify
  280.           data written to the disk.  This will increase the speed
  281.           of Disk OrGanizer but will allow data to be lost.  This
  282.           switch should not be used on a floppy disk, but may be
  283.           used on a hard disk at your own risk.
  284.  
  285.  
  286. COMMANDS
  287.  
  288.    [LOW] tells Disk OrGanizer to place the files described by
  289.           following filenames close to the FAT.  This also
  290.           affects the FREE command. (see below)
  291.  
  292.    [HIGH] tells Disk OrGanizer to place files described by
  293.           following filenames away from the FAT.  This also
  294.           affects the FREE command.
  295.  
  296.    [FORCE] tells Disk OrGanizer not to move the files that
  297.           follow. 
  298.  
  299.    [FLOAT] tells Disk OrGanizer to ignore the files that
  300.           follow.  This is used if you wish to TRUNCATE a sub-
  301.           directory but don't want to put it LOW, HIGH or FORCE. 
  302.           NOTE: in future releases this may be used to allow
  303.           HIDDEN and SYSTEM files to be moved.
  304.  
  305.    [TRUNCATE] subdirectories named between TRUNCATE and
  306.           ENDTRUNCATE will have there size changed so that they
  307.           will use as little space as possible.
  308.  
  309.    [ENDTRUNCATE] see TRUNCATE above.
  310.  
  311.    [FREE nn] tells Disk OrGanizer to leave nn clusters of free
  312.           space after the last file named in the order file if
  313.           files are being placed LOW or before the file if files
  314.           are being placed HIGH.  Disk OrGanizer ignores this
  315.           command if there isn't enough free disk space.  The nn
  316.           may be replaced with an asterisk (*) if you want all
  317.           available free clusters in a location.
  318.  
  319.  
  320.  
  321. FILE-IDENTIFIERS
  322.  
  323.     A file-identifier is a string that starts with a backslash
  324. (\), has zero or more subdirectory names, separated by back-
  325. slashes (the Path) and ends with a filename or subdirectory name. 
  326. A file-identifier ending with a subdirectory name can be followed
  327. by an optional backslash.
  328.  
  329.     It is important to understand that a sub-directory is a file
  330. with a special format and that Disk OrGanizer treats subdirec-
  331. tories just like files in the ORDER file except that sub-direc-
  332. tories can be TRUNCATED.
  333.  
  334.     You must always include the full path of a file or subdir-
  335. ectory.
  336.  
  337.     Wildcards may be used in filenames.  But please note that
  338. including a large number of files in the ORDER file can greatly
  339. increase the amount of time it take Disk OrGanizer to organize a
  340. disk.
  341.  
  342.  
  343. COMMENTS
  344.  
  345.     A comment starts with a semicolon and ends with a carriage
  346. return.
  347.  
  348.  
  349.  
  350. SAMPLE ORDER FILE
  351.  
  352.     Below is a simple ORDER file:
  353.  
  354. [FAST]                ; this sets the mode
  355. [TRUNCATE]
  356. \DIR_A\                ; Truncate subdirectory DIR_A, but let     
  357.                 ; it FLOAT.
  358.                                 ; 
  359. [LOW]                ; Set move files LOW.
  360. \DOS\                ; Truncate subdirectory DOS, and put it
  361.                 ; next to the FAT.
  362. [ENDTRUNCATE]
  363. \COMMAND.COM            ; COMMAND.COM will be placed after \DOS.
  364. [HIGH]                ; set move files HIGH.
  365. \AUTOEXEC.BAT            ; As this file is used only once, on
  366.                 ; reboot, we can move it away from the
  367.                 ; FAT.
  368. \ORDER.DOG            ; This file will be place just in front
  369.                  ; of AUTOEXEC.BAT
  370.  
  371. Appendix A
  372.  
  373.     This is to be added in the next release.
  374.  
  375.  
  376. INDEX
  377.  
  378.     /DATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
  379.     /DIREctory. . . . . . . . . . . . . . . . . . . . . . . . . . .4
  380.     /FAST . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
  381.     /FILL . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
  382.     COMMANDS. . . . . . . . . . . . . . . . . . . . . . . . . . . .7
  383.         [ENDTRUNCATE] . . . . . . . . . . . . . . . . . . . . . . .7
  384.         [FLOAT] . . . . . . . . . . . . . . . . . . . . . . . . . .7
  385.         [FORCE] . . . . . . . . . . . . . . . . . . . . . . . . . .7
  386.         [FREE nn] . . . . . . . . . . . . . . . . . . . . . . . . .7
  387.         [HIGH]. . . . . . . . . . . . . . . . . . . . . . . . . . .7
  388.         [LOW] . . . . . . . . . . . . . . . . . . . . . . . . . . .7
  389.         [TRUNCATE]. . . . . . . . . . . . . . . . . . . . . . . . .7
  390.     DOG=. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
  391.     ENDTRUNCATE . . . . . . . . . . . . . . . . . . . . . . . . . .7
  392.     Environment . . . . . . . . . . . . . . . . . . . . . . . . . .6
  393.     File-identifier . . . . . . . . . . . . . . . . . . . . . . . .8
  394.     Filename. . . . . . . . . . . . . . . . . . . . . . . . . . . .8
  395.     FLOAT . . . . . . . . . . . . . . . . . . . . . . . . . . . 6, 7
  396.     FORCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
  397.     FREE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
  398.     HIGH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
  399.     HIGH area . . . . . . . . . . . . . . . . . . . . . . . . . . .6
  400.     INTRODUCTION. . . . . . . . . . . . . . . . . . . . . . . . . .1
  401.     LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
  402.     LOW area. . . . . . . . . . . . . . . . . . . . . . . . . . . .6
  403.     Path. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
  404.     Shareware . . . . . . . . . . . . . . . . . . . . . . . . . . .1
  405.     SWITCHES. . . . . . . . . . . . . . . . . . . . . . . . . . . .6
  406.         [BATCH] . . . . . . . . . . . . . . . . . . . . . . . . . .7
  407.         [NOVERIFY]. . . . . . . . . . . . . . . . . . . . . . . . .7
  408.         [TRUNCATE ALL]. . . . . . . . . . . . . . . . . . . . . . .7
  409.     TRUNCATE. . . . . . . . . . . . . . . . . . . . . . . . . . . .7
  410.     Wildcards . . . . . . . . . . . . . . . . . . . . . . . . . . .8
  411.  
  412.