home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / DISK / DOG312.ZIP / DOG.DOC < prev    next >
Encoding:
Text File  |  1991-08-08  |  41.2 KB  |  1,142 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                          Disk OrGanizer - Version 3.12
  19.                                 August 8, 1991
  20.  
  21.                               Soft GAM's Software
  22.                               G. Allen Morris III
  23.                                  P. O. Box 1311
  24.                               Mendocino, CA  95460
  25.  
  26.                                  Copyright 1991
  27.                               All Rights Reserved
  28.  
  29.                             Compuserve: #73210,3374
  30.                               Voice: (707)961-1632
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                               _______
  38.                          ____|__     |               (tm)
  39.                       --|       |    |-------------------
  40.                         |   ____|__  |  Association of
  41.                         |  |       |_|  Shareware
  42.                         |__|   o   |    Professionals
  43.                       -----|   |   |---------------------
  44.                            |___|___|    MEMBER
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                                Table of Contents
  51.  
  52.  
  53.  
  54.  
  55.         1. Getting started ........................................... 1
  56.         1.1. Introduction ............................................ 1
  57.         1.2. Shareware ............................................... 1
  58.         1.3. Purpose ................................................. 1
  59.         1.4. Installation ............................................ 1
  60.         1.5. Background programs ..................................... 2
  61.         1.6. Copy protected programs ................................. 3
  62.         1.7. Power failure ........................................... 3
  63.         1.8. Quick start ............................................. 3
  64.  
  65.         2. Using Disk OrGanizer ...................................... 5
  66.         2.1. Modes ................................................... 5
  67.         2.2. Switches ................................................ 6
  68.         2.3. Command line syntax ..................................... 6
  69.         2.3.1. Command line commands ................................. 7
  70.         2.4. Orderfile syntax ........................................ 7
  71.         2.4.1. Setting the mode ...................................... 7
  72.         2.4.2. Setting switches ...................................... 8
  73.         2.4.3. Order file Commands ................................... 8
  74.         2.4.4. File identifiers ..................................... 10
  75.         2.4.5. Comments ............................................. 10
  76.  
  77.         3. Licensing and support .................................... 11
  78.         3.1. Copyright/License/Warranty ............................. 11
  79.         3.2. Licensing .............................................. 11
  80.         3.3. Technical Support ...................................... 12
  81.         3.4. ASP Ombudsman Information .............................. 12
  82.  
  83.         4. Error messages ........................................... 13
  84.  
  85.         5. Glossary ................................................. 16
  86.  
  87.         6. Index .................................................... 17
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.                                       i
  104.  
  105.      1. Getting started
  106.      ----------------------------------------------------------------------
  107.      1.1. Introduction
  108.  
  109.  
  110.         1.1. Introduction
  111.  
  112.         Hello,  and thank you for taking the time to read this manual. I
  113.         hope that you find Disk OrGanizer useful.
  114.  
  115.         1.2. Shareware
  116.  
  117.         Disk OrGanizer is not a public domain program.  Copies  of  Disk
  118.         OrGanizer  for  personal  use  are  free,  but  if you find Disk
  119.         OrGanizer of value, you are  encouraged  to  make  a  gift  ($20
  120.         suggested)  and  become a Disk OrGanizer supporter. You may also
  121.         register your copy of Disk OrGanizer for $30 and receive a  disk
  122.         and  manual  along  with  notification  of  future  versions.  A
  123.         license is required for use of Disk  OrGanizer  by  corporations
  124.         and institutions, and for its commercial distribution.
  125.  
  126.         If you don't support shareware it will go away.
  127.  
  128.         1.3. Purpose
  129.  
  130.         A  disk  that has been in use a while will usually become slower
  131.         accessing the data and programs that have  been  stored  on  it.
  132.         This is due to two problems:
  133.  
  134.          o  The disk has become fragmented.
  135.          o  There are deleted entries in directories.
  136.  
  137.         Disk  OrGanizer will solve these problems and make your disk run
  138.         like new.
  139.  
  140.         If the size of a directory decreases enough after  removing  the
  141.         deleted  entries,  Disk  OrGanizer  can  also  recover some disk
  142.         space.
  143.  
  144.         Disk OrGanizer has been tested with  MS-DOS  2.10,  3.01,  3.10,
  145.         3.30,  4.01 and 5.0 on logical drives as large as 600 megabytes.
  146.         It is believed that Disk OrGanizer will operate on any MS/PC-DOS
  147.         disk.
  148.  
  149.         Disk OrGanizer performs extensive tests before it starts to move
  150.         data, to make sure that the  File  Allocation  Table  (FAT)  and
  151.         directories are in good repair.
  152.  
  153.         1.4. Installation
  154.  
  155.         You should BACK UP your hard disk before you run Disk OrGanizer.
  156.  
  157.         To  install Disk OrGanizer, you need only copy it to a directory
  158.         on your PATH.
  159.  
  160.         You can test Disk OrGanizer by typing the command:
  161.  
  162.  
  163.  
  164.      Disk OrGanizer                                                       1
  165.  
  166.      1. Getting started
  167.      ----------------------------------------------------------------------
  168.      1.4. Installation
  169.  
  170.  
  171.              DOG [d:] /TEST
  172.  
  173.         d: is an optional drive specifier. (The []'s mean  optional  and
  174.         should  not  be  typed.)  If  no drive is specified, the current
  175.         drive will be used.
  176.  
  177.         If Disk OrGanizer reports errors  and  you  have  not  run  Disk
  178.         OrGanizer  before,  you should run CHKDSK with the /F switch and
  179.         repair the disk.
  180.  
  181.         If you have not backed up your disk, Disk  OrGanizer  will  warn
  182.         you as to how many files may need to be backed up.
  183.  
  184.         PLEASE back up your disks before you run Disk OrGanizer.
  185.  
  186.         Disk  OrGanizer will also list any files that are open on on the
  187.         disk that you are organizing. Disk OrGanizer will not be able to
  188.         move these files nor pack the directories that they are in.
  189.  
  190.         If you have used other disk defragment programs before, and have
  191.         had no problem, it should be safe to run Disk OrGanizer.
  192.  
  193.         Disk OrGanizer will move HIDDEN files,  most other disk  defrag-
  194.         menters don't move these files.
  195.  
  196.         If  you  have  not  run any disk defragment programs before, you
  197.         should read the rest of this chapter.
  198.  
  199.         1.5. Background programs
  200.  
  201.         Disk OrGanizer reads and writes to the disk directly. If a  pro-
  202.         gram  tries  to  write  to  the  disk  while  Disk  OrGanizer is
  203.         operating, data may be lost. You should not run  Disk  OrGanizer
  204.         on  a  disk  that you know will be written to. Programs that are
  205.         likely to write to the disk are printer  spoolers,  multitasking
  206.         programs  like  Windows or DesqView, switching programs and net-
  207.         work programs.
  208.  
  209.         If you have FASTOPEN installed on your computer, you  will  need
  210.         to reboot your computer after you run Disk OrGanizer.
  211.  
  212.         Some  background programs leave files open all of the time. Disk
  213.         OrGanizer will not move files that are open,  and  it  will  not
  214.         pack a directory that has open files in it.
  215.  
  216.         If  you do not know if you have these programs on your computer,
  217.         I would suggest that you run Disk OrGanizer from a  floppy  disk
  218.         as described in the Quick Start section.
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.      Disk OrGanizer                                                       2
  226.  
  227.      1. Getting started
  228.      ----------------------------------------------------------------------
  229.      1.6. Copy protected programs
  230.  
  231.  
  232.         1.6. Copy protected programs
  233.  
  234.         Disk OrGanizer may make some copy protected software unusable.
  235.  
  236.         It  is  recommended  that you remove any copy protected software
  237.         from your disk before you  run  Disk  OrGanizer,  if  you  can't
  238.         determine its compatibility with Disk OrGanizer.
  239.  
  240.         1.7. Power failure
  241.  
  242.         Disk OrGanizer can recover from a power failure or reboot.
  243.  
  244.         If  a  power  failure  or  inadvertent  reboot occurs while Disk
  245.         OrGanizer is running, you should run  Disk  OrGanizer  again  as
  246.         soon  as possible. Disk OrGanizer will report any errors that it
  247.         finds on the disk and ask you if you would like to repair  them.
  248.         If  you  answer yes to all of the questions, Disk OrGanizer will
  249.         repair the disk and then continue operation as normal.
  250.  
  251.         You should not use any third party  CHKDSK  type  programs  that
  252.         recover  lost  clusters.  If you use CHKDSK, you should NOT make
  253.         the lost cluster chains into files.
  254.  
  255.         1.8. Quick start
  256.  
  257.         If you would like to defragment your disk and get back  to  work
  258.         without having to read the rest of this manual, the simplest and
  259.         safest way to run Disk OrGanizer is described here.
  260.  
  261.         The first thing to do is to find an old or unused  floppy  disk.
  262.         Then format this disk with a copy of the system.
  263.  
  264.              FORMAT A: /sys
  265.  
  266.         Copy DOG.EXE to the floppy disk.
  267.  
  268.              COPY DOG.EXE A:
  269.  
  270.         You may need to create or copy CONFIG.SYS on the new disk if you
  271.         have disk drivers or an EMS  memory  driver  that  needs  to  be
  272.         installed.
  273.  
  274.         Reboot  your  computer  (Ctrl-Alt-Delete)  with the new disk in-
  275.         stalled in the A: drive.
  276.  
  277.         DOS will ask you for the date and time. This is because there is
  278.         no AUTOEXEC.BAT file.  Enter the correct date and time.
  279.  
  280.         Run Disk OrGanizer on your hard disk.
  281.  
  282.              DOG C: /AUTO /CRC /TRUNCATE
  283.  
  284.  
  285.  
  286.      Disk OrGanizer                                                       3
  287.  
  288.      1. Getting started
  289.      ----------------------------------------------------------------------
  290.      1.8. Quick start
  291.  
  292.  
  293.  
  294.         Disk  OrGanizer  will  test  the  disk (like CHKDSK), give you a
  295.         report, analyze the disk to determine the best place to have the
  296.         directories and files on the disk. Tell you how many directories
  297.         need to have deleted files removed (packed), tell you  how  many
  298.         directories  can  be  made shorter (truncated), and tell you the
  299.         number of clusters that it will have to move to  defragment  the
  300.         files and directories on the disk.
  301.  
  302.         You  will then be asked if it is OK to write to the disk. If you
  303.         answer no to this question, Disk  OrGanizer  will  quit  without
  304.         ever  having  written  to  the  disk.  If  you  answer yes, Disk
  305.         OrGanizer will pack the directories, truncate  the  directories,
  306.         and then start moving clusters.
  307.  
  308.         While  Disk  OrGanizer is moving clusters, you will see the fol-
  309.         lowing message:
  310.  
  311.              X nnnnn - elapsed time  0:00:00  estimated 0:00:00
  312.  
  313.         X  is  either  R)eading,  S)orting,  C)omputing  CRC,  W)riting,
  314.         T)esting  CRC,  L)inking  new  clusters  or  U)pdating  FAT  and
  315.         directories. nnnnn is the number  of  clusters  that  have  been
  316.         moved.  Elapsed  time  is  the amount of time Disk OrGanizer has
  317.         been moving clusters, and estimated is the approximate amount of
  318.         time it will take to organize the disk.
  319.  
  320.         You  can quit from Disk OrGanizer at anytime by pressing the es-
  321.         cape (Esc) key or a ^C. Stopping  Disk  OrGanizer  while  it  is
  322.         moving  clusters  may  cause  extreme fragmentation.  Rerun Disk
  323.         OrGanizer as soon as possible, if you abort while it  is  moving
  324.         clusters.
  325.  
  326.         If  you think that Disk OrGanizer has stopped running, press the
  327.         space bar.  You should then hear a beep within a few seconds.
  328.  
  329.         When it is done it will check the disk once again,  give  you  a
  330.         new report and then exit.
  331.  
  332.         You  should  then  remove the floppy disk from the A: drive, and
  333.         reboot your computer.
  334.  
  335.         You should notice that the programs on your disk load  a  little
  336.         faster.  If  Disk  OrGanizer truncated some directories you will
  337.         also have more free disk space.
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.      Disk OrGanizer                                                       4
  348.  
  349.      2. Using Disk OrGanizer
  350.      ----------------------------------------------------------------------
  351.  
  352.  
  353.         The purpose of Disk OrGanizer is to speed up the access of files
  354.         on your disks.  There are two things that slow  down  access  of
  355.         data:  deleted  files  in directories, and fragmented files. The
  356.         actual placement of files on a disk has very little to  do  with
  357.         the  amount  of time it takes to load a file.  Most disk defrag-
  358.         ment programs take a long time to run,  and  this  keeps  people
  359.         from running them often.
  360.  
  361.         Disk  OrGanizer  has complex algorithms that allow it to defrag-
  362.         ment all of the files on a disk while moving very few  clusters.
  363.         Although  Disk  OrGanizer can control the placement of files and
  364.         directories on the disk, I would suggest that you  refrain  from
  365.         using  this  feature,  as  it can greatly increase the number of
  366.         clusters that Disk OrGanizer will need to move and give you very
  367.         little  benefit.  The exception to this are directories that are
  368.         read often, such as the directories on the PATH, which  you  may
  369.         want  to  move  near  the  File  Allocation  Table (see the AUTO
  370.         command.)
  371.  
  372.         2.1. Modes
  373.  
  374.         The mode determines how Disk OrGanizer will organize a disk.
  375.  
  376.         FILL - mode will defragment files and put them as close  to  the
  377.              FAT as possible, FILL will not leave any free space between
  378.              files. FILL may leave  files  fragmented  around  BAD  disk
  379.              sectors and unmovable files. This mode gives you all of the
  380.              benefits of that you get from other disk defragmenter,  but
  381.              only takes a fraction of the time to run.
  382.  
  383.         FAST - mode will defragment all files and attempt to put them in
  384.              one area of disk space. FAST may leave gaps of  free  space
  385.              between files.
  386.  
  387.         QUICK - mode is like FAST mode but does not try as hard.
  388.  
  389.         DEFRAG -  mode  will  defragment  the files on the drive without
  390.              concern for their placement.
  391.  
  392.         The following modes will more than likely cause all of the files
  393.         and sub-directories on a disk to be moved.
  394.  
  395.         DATE -  mode  will  put the files on the disk oldest files first
  396.              (closest to the FAT). Using this mode once in a  while,  it
  397.              can  take  a  long  time to run, may decrease the number of
  398.              clusters that Disk OrGanizer will need  to  move  with  the
  399.              FAST or FILL mode.
  400.  
  401.         DIRECTORY -  mode will put the files on the disk in the order in
  402.              finds them in the directories. That is, the first  file  or
  403.              sub-directory  in the root directory will be closest to the
  404.              FAT (also refered to as LOW), followed by the  second  file
  405.  
  406.  
  407.  
  408.      Disk OrGanizer                                                       5
  409.  
  410.      2. Using Disk OrGanizer
  411.      ----------------------------------------------------------------------
  412.      2.1. Modes
  413.  
  414.  
  415.              in the root, etc.
  416.  
  417.         The  following  modes  are  for compatibility to older versions.
  418.         They are of little use.
  419.  
  420.         FRAGMENTED - This will put all of the files that are  not  frag-
  421.              mented  on the disk first, and will then put the fragmented
  422.              files on the disk. Using this function will slowly put  all
  423.              of  the files that change size away from the FAT. This mode
  424.              does not work well if you have BAD clusters or system files
  425.              other than DOS on the disk.
  426.  
  427.         PACKED -  This  leaves  the  files in the same order as it finds
  428.              them on the disk, by cluster.
  429.  
  430.         2.2. Switches
  431.  
  432.         CRC - will cause Disk OrGanizer to read data after it is written
  433.              to  the  disk,  and  test  to make sure that it was written
  434.              correctly.
  435.  
  436.         BATCH - tells Disk OrGanizer to suppress all  prompts.  This  is
  437.              useful  for  running  Disk  OrGanizer from a batch file. If
  438.              this switch is set, any error will cause Disk OrGanizer  to
  439.              terminate.
  440.  
  441.         NOVERIFY -  tells  DOS  not  to verify data written to the disk.
  442.              (see VERIFY in your DOS  manual)  This  will  increase  the
  443.              speed  of  Disk  OrGanizer, but will allow data to be lost.
  444.              This switch should not be used on a floppy disk, but may be
  445.              used on a hard disk at your own risk. This is for people to
  446.              whom speed is more important than data  integrity.  If  you
  447.              have  set  the  CRC switch, then Disk Organizer will verify
  448.              the data, and  you  can  include  this  switch  to  improve
  449.              performance.
  450.  
  451.         2.3. Command line syntax
  452.  
  453.         The  Command  line  syntax  to  run  Disk OrGanizer from the DOS
  454.         prompt is:
  455.  
  456.              DOG [d:] [orderfile] [/commands] [/mode] [/switches]
  457.  
  458.         (The []'s mean optional and should not be typed.)
  459.  
  460.         d: is an optional drive specifier. If no drive is specified  the
  461.         current drive will be organized.
  462.  
  463.         Orderfile is the path and filename of the order file. If this is
  464.         not included,  Disk  OrGanizer  will  look  for  a  file  called
  465.         ORDER.DOG  in  the  root directory of the drive being organized,
  466.         and if it does not find that, it will look  in  the  environment
  467.  
  468.  
  469.      Disk OrGanizer                                                       6
  470.  
  471.      2. Using Disk OrGanizer
  472.      ----------------------------------------------------------------------
  473.      2.3. Command line syntax
  474.  
  475.  
  476.         for  DOG=d:\path\filename and use that file.  If no orderfile is
  477.         found, the DOS NUL device is used.  If you have an orderfile and
  478.         don't wish to use it, you can tell Disk OrGanizer to use the NUL
  479.         file as an orderfile (ie. DOG NUL /AUTO).
  480.  
  481.         Commands consist of AUTO and TRUNCATE.
  482.  
  483.         Mode tells Disk OrGanizer where to place the files on the drive.
  484.         You  must  supply  a  mode  to  suppress  the  shareware sign-on
  485.         message. The mode can be set  on  the  command  line  or  in  an
  486.         orderfile.
  487.  
  488.         Switches  allow  you  to  control several options as to how Disk
  489.         OrGanizer will test the data that is moved,  and  interact  with
  490.         the  operator.  Switches can be set on the command line or in an
  491.         orderfile.
  492.  
  493.         2.3.1. Command line commands
  494.  
  495.         TRUNCATE - tells Disk OrGanizer to truncate all sub-directories.
  496.  
  497.         AUTO - tells Disk OrGanizer to put the  directories  defined  in
  498.              the  PATH  environment variable first, followed by the file
  499.              definded by the COMSPEC environment variable, and then  all
  500.              of  the  other  directories.  If  no  other  mode  has been
  501.              specified, it will then order the rest of the files  as  if
  502.              the /FILL mode was set.
  503.  
  504.         2.4. Orderfile syntax
  505.  
  506.         The orderfile can be used as a simple configuration file, or can
  507.         be used to tell DOG the exact order that you would like to  have
  508.         your files on a disk.
  509.  
  510.         Modes  and  switches  that  are  given  on the command line will
  511.         override those in the orderfile.
  512.  
  513.         You may find it more convenient to run  Disk  OrGanizer  from  a
  514.         batch  file  than  to  use the orderfile feature.  Again I would
  515.         like to point out that the placement of files has little  effect
  516.         on the speed at which they can be read.
  517.  
  518.         If  you  use  the  AUTO command line command, you may not end up
  519.         with what you expected. (See listing 2.1)
  520.  
  521.         2.4.1. Setting the mode
  522.  
  523.         To give a mode in the order file, enclose it in square  brackets
  524.         ([]).  A  mode must be given on the command line or in the order
  525.         file for Disk OrGanizer to run. For a description of  the  modes
  526.         see  above.  A  mode given on the command line will override the
  527.         mode in the ORDER file.
  528.  
  529.  
  530.      Disk OrGanizer                                                       7
  531.  
  532.      2. Using Disk OrGanizer
  533.      ----------------------------------------------------------------------
  534.      2.4.2. Setting switches
  535.  
  536.  
  537.         ________________________________________________________________
  538.                    Listing 2-1: A very simple ORDER.DOG file
  539.  
  540.               ; The []s must be included.
  541.               [FILL]          ; set the mode
  542.               ;  Truncate all of the directories
  543.               [TRUNCATE ALL]  ; Directories that have already been
  544.                               ; specified, will not be truncated.
  545.               ; The AUTO command line command appends
  546.               [PATH]          ; these three orderfile commands
  547.               [COMSPEC]       ; to the end of the orderfile.
  548.               [ALLDIR]        ;
  549.               ;
  550.  
  551.         ________________________________________________________________
  552.  
  553.         2.4.2. Setting switches
  554.  
  555.         Switches can be specified in the orderfile by enclosing them  in
  556.         square brackets ([]). (See the section on switches above.)
  557.  
  558.         2.4.3. Order file Commands
  559.  
  560.         The area of the disk close to the FAT is called the LOW area and
  561.         the area away from the FAT is called the HIGH area.    Any  file
  562.         that  is  not  named  anywhere  in the ORDER.DOG file is said to
  563.         FLOAT.
  564.  
  565.         In making this file you should name as few files as possible.
  566.  
  567.         The following three  commands  are  a  shorthand  for  file  and
  568.         directory names.
  569.  
  570.         PATH - is the same as listing all of the directories in the PATH
  571.              environment variable that are on the drive being organized.
  572.  
  573.         COMSPEC - The filename given in the COMSPEC environment variable
  574.              is used if it points to the drive being organized.
  575.  
  576.         ALLDIRECTORIES -  Is  the same as listing all of the directories
  577.              on the drive.
  578.  
  579.         The following commands tell where to place named files.
  580.  
  581.         LOW - tells Disk OrGanizer to place the files described by  fol-
  582.              lowing  filenames  close to the FAT.  This also affects the
  583.              FREE command. (see below)
  584.  
  585.         HIGH - tells Disk OrGanizer to place files described by  follow-
  586.              ing  filenames  away  from  the FAT.  This also affects the
  587.  
  588.  
  589.  
  590.  
  591.      Disk OrGanizer                                                       8
  592.  
  593.      2. Using Disk OrGanizer
  594.      ----------------------------------------------------------------------
  595.      2.4.3. Order file Commands
  596.  
  597.  
  598.         ________________________________________________________________
  599.                        Listing 2-2: Sample ORDER.DOG file
  600.  
  601.            ;
  602.            [DEFRAGMENT]    ; if no mode is given on the command
  603.                            ; line use DEFRAGMENT
  604.            [FORCE]         ;
  605.            \COPYPRO.SYS    ; I don't want this file to move
  606.            [FLOAT]
  607.            [TRUNCATE]      ;
  608.            \DIR_A\         ; Truncate sub-directory DIR_A, but let
  609.                            ; it FLOAT.
  610.            ;
  611.            [LOW]           ; Set move files LOW.
  612.            \DOS\           ; Truncate sub-directory DOS, and put it
  613.                            ; next to the FAT.
  614.            [ENDTRUNCATE]
  615.            \COMMAND.COM    ; COMMAND.COM will be placed after \\DOS.
  616.            [FREE 500]      ; leave some room
  617.            ;
  618.            [HIGH]          ; set move files HIGH.
  619.            \AUTOEXEC.BAT   ; As this file is used only once, on
  620.                            ; reboot, we can move it away from the
  621.                            ; FAT.
  622.            \CONFIG.SYS     ; another seldom used file.
  623.            \ORDER.DOG      ; This file will be place just in front
  624.                            ; of CONFIG.SYS
  625.  
  626.         ________________________________________________________________
  627.  
  628.              FREE command.
  629.  
  630.         FORCE - tells Disk OrGanizer not to move the files that  follow.
  631.              If  you are going to FORCE file you should do it before you
  632.              place files LOW or HIGH.
  633.  
  634.         FLOAT - tells Disk OrGanizer to ignore the  files  that  follow.
  635.              This  is  used  if you wish to TRUNCATE a sub-directory but
  636.              don't want to put it LOW, HIGH or FORCE.  NOTE:  in  future
  637.              releases  this may be used this to allow SYSTEM files to be
  638.              moved.
  639.  
  640.         These  commands  control  whether  named  directories  will   be
  641.         truncated.
  642.  
  643.         TRUNCATE ALL - will truncate all directories on the disk.
  644.  
  645.         TRUNCATE -    sub-directories   named   between   TRUNCATE   and
  646.              ENDTRUNCATE will have there size changed so that they  will
  647.              use as little space as possible.
  648.  
  649.  
  650.  
  651.  
  652.      Disk OrGanizer                                                       9
  653.  
  654.      2. Using Disk OrGanizer
  655.      ----------------------------------------------------------------------
  656.      2.4.3. Order file Commands
  657.  
  658.  
  659.         ENDTRUNCATE - see TRUNCATE above.
  660.  
  661.         System directories and directories that have already been placed
  662.         LOW, HIGH, or FORCED, will not be truncated.
  663.  
  664.         The following command will force clusters to be left free.
  665.  
  666.         FREE nnnn - tells  Disk  OrGanizer  to  leave  nnnn  (a  number)
  667.              clusters  of  free  space  after the last file named in the
  668.              order file, if files are being placed LOW,  or  before  the
  669.              file if files are being placed HIGH. Disk OrGanizer ignores
  670.              this command if there isn't enough free disk  space.    The
  671.              nnnn  may  be replaced with an asterisk (*) if you want all
  672.              available free clusters in a location.
  673.  
  674.         2.4.4. File identifiers
  675.  
  676.         A file identifier is a string that starts with a backslash  (\),
  677.         has  zero  or  more sub-directory names separated by backslashes
  678.         (the Path), and ends with a filename or  sub-directory  name.  A
  679.         file identifier ending with a sub-directory name can be followed
  680.         by an optional backslash.
  681.  
  682.         It is important to understand that a  sub-directory  is  a  file
  683.         with  a  special  format  and  that  Disk  OrGanizer treats sub-
  684.         directories just like files in the orderfile  except  that  sub-
  685.         directories can be TRUNCATED.
  686.  
  687.         You  must  always  include  the  full  path  of  a  file or sub-
  688.         directory.
  689.  
  690.         Wildcards may be used in filenames.  But please  note  that  in-
  691.         cluding  a  large  number of files in the ORDER file can greatly
  692.         increase the amount of time it take Disk OrGanizer to organize a
  693.         disk.
  694.  
  695.         2.4.5. Comments
  696.  
  697.         A  comment  starts  with  a  semicolon  and ends with a carriage
  698.         return.
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.      Disk OrGanizer                                                      10
  714.  
  715.      3. Licensing and support
  716.      ----------------------------------------------------------------------
  717.      3.1. Copyright/License/Warranty
  718.  
  719.  
  720.         3.1. Copyright/License/Warranty
  721.  
  722.         This document and the program files DOG.EXE ("the software") are
  723.         copyrighted  by the author.  The copyright owner hereby licenses
  724.         you to use the software given these restrictions:
  725.  
  726.          o  the program shall be supplied in  its  original,  unmodified
  727.             form, which includes this documentation;
  728.  
  729.          o  for-profit use without a license is prohibited;
  730.  
  731.          o  the  program  may  not be included - or bundled - with other
  732.             goods or services.  Exceptions may be granted  upon  written
  733.             request only.
  734.  
  735.          o  no fee is charged; an exception is granted to not for profit
  736.             user's groups, which are permitted to  charge  a  small  fee
  737.             (not  to  exceed  $5)  for materials, handling, postage, and
  738.             general overhead.  No other  organization  is  permitted  to
  739.             charge any amount for distribution of copies of the software
  740.             or documentation, or to include copies of  the  software  or
  741.             documentation with sales of their own products.
  742.  
  743.         There  is  no warranty of any kind.  The copyright owner may not
  744.         be held liable for any damages, including any  lost  profits  or
  745.         other  incidental or consequential damages arising out of or in-
  746.         ability to use the software.  By using the software,  you  agree
  747.         to this.
  748.  
  749.         3.2. Licensing
  750.  
  751.         No  license is required to run Disk OrGanizer on a computer that
  752.         is not used for business.
  753.  
  754.         The fee for a license depends on the estimated number of  copies
  755.         of  the program that you will use.  For local area networks, one
  756.         copy must be licensed for each computer that will be  using  the
  757.         program on the network.
  758.  
  759.         A license is not transferable.
  760.  
  761.                      Quantity     Price  Update
  762.                      ========     ==.==   ==.==
  763.                             1     30.00    6.00  each
  764.  
  765.                        2 to 9     25.00    5.00
  766.                      10 to 49     20.00    4.00
  767.                      50 to 99     15.00    3.00
  768.                    100 to 199     10.00    2.00
  769.  
  770.         Unlimited at one site  $2000.00  400.00
  771.              Additional sites   1000.00  200.00  unlimited at each site
  772.  
  773.  
  774.      Disk OrGanizer                                                      11
  775.  
  776.      3. Licensing and support
  777.      ----------------------------------------------------------------------
  778.      3.2. Licensing
  779.  
  780.  
  781.  
  782.         The  price  to update to a new version applies only to the quan-
  783.         tity previously registered.
  784.  
  785.         Regardless of the quantity purchased you will receive  only  one
  786.         disk  and  one  printed manual. Additional manuals are available
  787.         for $6.00 each. You may make as many copies as are licensed  and
  788.         one archive copy.
  789.  
  790.         Orders of $50 or less must be prepaid. Orders over $50 - NET 30.
  791.  
  792.              Soft GAM's Software    SSN# 559-29-3621
  793.              (707)961-1470
  794.              P. O. Box 1311
  795.              Mendocino, CA  95460
  796.  
  797.         3.3. Technical Support
  798.  
  799.         Technical support is available to Disk OrGanizer supporters  and
  800.         licensed users. Limited support is also available to help you to
  801.         get Disk OrGanizer to operate on a computer,  so  that  you  can
  802.         evaluate it.
  803.  
  804.              CompuServe: PPN# 73210,3374
  805.  
  806.              the Bit Boutique BBS 707-778-8944, 2400 baud
  807.              Leave E-Mail to ALLEN MORRIS
  808.  
  809.              Mail : Soft GAM's Software, Box 1311, Mendocino, CA 95460
  810.  
  811.              Phone: (707)961-1632 (10 to 6 Pacific Time)
  812.  
  813.         3.4. ASP Ombudsman Information
  814.  
  815.         Disk  OrGanizer  is  produced  by a member of the Association of
  816.         Shareware Professionals (ASP).  ASP wants to make sure that  the
  817.         shareware principle works for you.  If you are unable to resolve
  818.         a shareware-related problem with an ASP member by contacting the
  819.         member  directly, ASP may be able to help. The ASP ombudsman can
  820.         help you resolve a dispute or problem with an  ASP  member,  but
  821.         does  not  provide  technical  support  for  members'  products.
  822.         Please write to the ASP Ombudsman at:
  823.  
  824.              ASP Ombudsman
  825.              545 Grover Road
  826.              Muskegon, MI 49442
  827.  
  828.         or send a CompuServe message via Easyplex electronic mail to the
  829.         ASP Ombudsman, CompuServe ID number 70475,1071.
  830.  
  831.  
  832.  
  833.  
  834.  
  835.      Disk OrGanizer                                                      12
  836.  
  837.      4. Error messages
  838.      ----------------------------------------------------------------------
  839.  
  840.  
  841.         The number in parentheses is the  ERRORLEVEL  returned  by  Disk
  842.         OrGanizer. If the error code is 100 or above, data may have been
  843.         lost on the disk.
  844.  
  845.         No Errors (0)
  846.              You are a happy camper.
  847.  
  848.         Terminated by user. (1)
  849.              The disk may still need to be organized.
  850.  
  851.         Illegal I/O redirection. (2)
  852.              Do not redirect output to the drive being organized.
  853.  
  854.         Order file is a device. (3)
  855.              The order file can't be read from a device, use a file.
  856.  
  857.         File not found. (4)
  858.              Check the filename you entered.
  859.  
  860.         Could not read/understand disk information. (5)
  861.              Please write or call and we can try to solve this problem.
  862.  
  863.         Error in order file. (6)
  864.              Fix or remove bad commands  or  filenames  from  the  order
  865.              file.
  866.  
  867.         Error on the command line. (7)
  868.              Check the syntax on the command line.
  869.  
  870.         Network drive. (8)
  871.              Reboot  your  computer without the network or don't publish
  872.              the drive you want to organize.
  873.  
  874.         Invalid drive. (9)
  875.              Specify a valid drive.
  876.  
  877.         Could not find directory for open file. (10)
  878.              Remove background programs or reboot the computer  and  try
  879.              again.
  880.  
  881.         Out of memory. (11)
  882.              Remove  TSR  programs,  increase  EMS memory or set the en-
  883.              vironment variable TEMP or DOGTEMP to a path  that  can  be
  884.              used for temporary storage.
  885.  
  886.         Error reading FAT. (I/O) (12)
  887.              Back up and reformat the disk or mark bad clusters bad.
  888.  
  889.         Possible NON DOS disk. (13)
  890.              The  disk  is an unknown type or the second FAT is bad. Run
  891.              chkdsk.  If you are still unable  to  run  Disk  OrGanizer,
  892.  
  893.  
  894.  
  895.  
  896.      Disk OrGanizer                                                      13
  897.  
  898.      4. Error messages
  899.      ----------------------------------------------------------------------
  900.  
  901.  
  902.              Please call or write.
  903.  
  904.         Bad cluster in FAT. (14)
  905.              Run chkdsk.  If you are still unable to run Disk OrGanizer,
  906.              Please call or write.
  907.  
  908.         Error reading Directory (I/O) (15)
  909.              Back up and reformat the disk or mark bad clusters bad.
  910.  
  911.         Directory is corrupt. (16)
  912.              Run CHKDSK to repair the disk.
  913.  
  914.         Lost clusters found. (17)
  915.              Run CHKDSK to repair the disk or run Disk OrGanizer without
  916.              the BATCH or TEST switches set.
  917.  
  918.         You must have at least one free cluster. (18)
  919.              You should delete at least one file.
  920.  
  921.         Too many total files. (19)
  922.              Delete files from the disk until there are less that 32,752
  923.              files.
  924.  
  925.         Free clusters in FAT doesn't match DOS (21)
  926.              Remove any background programs that write to the disk.
  927.  
  928.         Could not CHDIR to root. (22)
  929.              I do not know what could cause this error.
  930.  
  931.         Too many fragmented files, use DIR mode. (23)
  932.              Use DIRECTORY, or DATE mode.  Once the number of fragmented
  933.              files is reduced you  use  the  mode  that  generated  this
  934.              error.
  935.  
  936.         No mode was given. (24)
  937.              You  must supply a mode on the command line or in the order
  938.              file.
  939.  
  940.         Incorrect DOS version. (42)
  941.              Reboot with DOS version 2 or greater.
  942.  
  943.         STDIN or STDERR redirected. (43)
  944.              Do not redirect the input or error output.
  945.  
  946.         Too many arguments. (44)
  947.              Remove some commands from the command line.
  948.  
  949.         Critical errors. (45)
  950.              Fix the problem that caused the critical error.
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.      Disk OrGanizer                                                      14
  958.  
  959.      4. Error messages
  960.      ----------------------------------------------------------------------
  961.  
  962.  
  963.         INTERNAL ERROR @'code'. (90)
  964.              Please call and tell me the code that you received.
  965.  
  966.         I/O error moving clusters. Disk is OK. (99)
  967.              An  I/O  error  was  detected.   You should run a disk test
  968.              program on the disk or back up the disk,  reformat  it  and
  969.              restore the data.  No data was lost and the disk is in good
  970.              repair.
  971.  
  972.         I/O error moving clusters. Data may have been lost. (100)
  973.              An I/O error was detected. You should run a disk test  pro-
  974.              gram  on  the disk or back up the disk, reformat it and re-
  975.              store the data.  There may be errors on the disk.
  976.  
  977.         I/O error Packing (101)
  978.              There was an error Packing a directory. You  should  run  a
  979.              disk test program on the disk or back up the disk, reformat
  980.              it and restore the data.  There may be errors on the disk.
  981.  
  982.         Critical errors. (102)
  983.              Fix the problem that caused the critical error.  There  may
  984.              be errors on the disk.
  985.  
  986.         INTERNAL ERROR @'code'. (200)
  987.              Please call and tell me the code that you got. There may be
  988.              errors on the disk.
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.      Disk OrGanizer                                                      15
  1019.  
  1020.      5. Glossary
  1021.      ----------------------------------------------------------------------
  1022.  
  1023.  
  1024.  
  1025.         CHKDSK  -  A  program  that  came  with  DOS.  Its  full name is
  1026.         CHKDSK.COM. See your DOS manual for more information.
  1027.  
  1028.         Cluster - DOS stores data in cluster units. Clusters are made of
  1029.         one or more sectors.
  1030.  
  1031.         FAT - The File Allocation Table.
  1032.  
  1033.         File Allocation Table - This along with the directories tell DOS
  1034.         where to find a file on the disk.
  1035.  
  1036.         Hidden file - A file with the hidden  attribute  bit  set.  Disk
  1037.         OrGanizer will move these files.
  1038.  
  1039.         Hidden  directory  -  A  directory with the hidden attribute bit
  1040.         set. Disk OrGanizer will move these directories.
  1041.  
  1042.         Lost clusters - Clusters that are mark in the FAT as being used,
  1043.         but have no directory entry that points to them.
  1044.  
  1045.         Null file - A file with no data in it.
  1046.  
  1047.         Sector - The smallest unit that data can be stored on a disk.
  1048.  
  1049.         System  file  -  A  file with the system attribute bit set. Disk
  1050.         OrGanizer will not move these files.
  1051.  
  1052.         System directory - A directory with  the  system  attribute  bit
  1053.         set.  Disk OrGanizer will not move these directories.
  1054.  
  1055.         User  file  - A file that does not have the system or hidden at-
  1056.         tribute bits set. Disk OrGanizer will move these files.
  1057.  
  1058.         User directory - A directory that does not have  the  system  or
  1059.         hidden  attribute  bits  set.  Disk  OrGanizer  will  move these
  1060.         directories.
  1061.  
  1062.         Volume label - A special file that tells DOS the name of a disk.
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.      Disk OrGanizer                                                      16
  1080.  
  1081.      6. Index
  1082.      ----------------------------------------------------------------------
  1083.  
  1084.  
  1085.         Aborting from DOG  4           Order file Commands (Cont.)
  1086.         ALLDIRECTORIES  8                 FORCE  9
  1087.         AUTO  7                           FREE nnnn  10
  1088.         BATCH  6                          HIGH  8
  1089.         CHKDSK  3, 16                     LOW  8
  1090.         Cluster  16                       PATH  8
  1091.         Command line commands             TRUNCATE ALL  9
  1092.            AUTO  7                        TRUNCATE  9
  1093.            TRUNCATE  7                 orderfile  6
  1094.         COMSPEC  7, 8                  PACKED  6
  1095.         Copy protected programs  3     PATH  7, 8
  1096.         CRC  6                         QUICK  5
  1097.         current drive  6               Sector  16
  1098.         DATE  5                        Switches
  1099.         DEFRAG  5                         BATCH  6
  1100.         DIRECTORY  5                      CRC  6
  1101.         drive specifier  6                NOVERIFY  6
  1102.         ENDTRUNCATE  9                 System directory  16
  1103.         environment                    System file  16
  1104.            COMSPEC  7                  Technical Support  12
  1105.            PATH  7                     TRUNCATE ALL  9
  1106.         FAST  5                        TRUNCATE  7, 9
  1107.         FASTOPEN  2                    User directory  16
  1108.         FAT  16                        User file  16
  1109.         File Allocation Table  16
  1110.         FILL  5
  1111.         FLOAT  9
  1112.         FORCE  9
  1113.         FRAGMENTED  6
  1114.         FREE nnnn  10
  1115.         Hidden directory  16
  1116.         Hidden file  16
  1117.         HIGH  8
  1118.         Lost clusters  16
  1119.         LOW  8
  1120.         Modes
  1121.            DATE  5
  1122.            DEFRAG  5
  1123.            DIRECTORY  5
  1124.            FAST  5
  1125.            FILL  5
  1126.            FRAGMENTED  6
  1127.            PACKED  6
  1128.            QUICK  5
  1129.         NOVERIFY  6
  1130.         NUL device  7
  1131.         Null file  16
  1132.         Open files  2
  1133.         Order file Commands
  1134.            ALLDIRECTORIES  8
  1135.            COMSPEC  8
  1136.            ENDTRUNCATE  9
  1137.            FLOAT  9
  1138.  
  1139.  
  1140.      Disk OrGanizer                                                      17
  1141.  
  1142.