home *** CD-ROM | disk | FTP | other *** search
/ CBM Funet Archive / cbm-funet-archive-2003.iso / cpm / sys / c128 / utils / rootsm.arc / CLEANUP.DOC < prev    next >
Text File  |  1979-12-31  |  4KB  |  135 lines
  1.                  roots cLEANUP uTILITY
  2.  
  3.    
  4.  
  5.    
  6.  
  7.    
  8.  
  9.    uSING cleanup
  10.  
  11.    
  12.  
  13.    
  14.  
  15.    tHE  roots  cLEANUP uTILITY IS DESIGNED TO REMOVE
  16.  
  17.    SUPERFLUOUS  DATA  FROM  A  roots89   OR  roots/m
  18.  
  19.    BASEFILE  AND REORGANIZE THE  REMAINING  DATA  SO
  20.  
  21.    THAT  A  MAXIMUM  AMOUNT  OF  MEMORY   SPACE   IS
  22.  
  23.    AVAILABLE FOR NEW DATA.  mAKE  CERTAIN  THAT  YOU
  24.  
  25.    ALWAYS HAVE A BACKUP COPY OF YOUR BASEFILE BEFORE
  26.  
  27.    RUNNING cleanup.
  28.  
  29.    
  30.  
  31.    tHE  cLEANUP UTILITY DOES NOT RUN AS PART OF  THE
  32.  
  33.    roots  PROGRAM,  BUT IS CALLED DIRECTLY FROM  THE
  34.  
  35.    OPERATING SYSTEM.  iF USING  THE  hdos  OPERATING
  36.  
  37.    SYSTEM, TYPE:
  38.  
  39.    
  40.  
  41.                    cleanup syN:basefile.bin
  42.  
  43.    
  44.  
  45.    TO  START  THE  cLEANUP UTILITY.  uSE  THE  DRIVE
  46.  
  47.    NUMBER,  N,  ON  WHICH THE COPY  OF  basefile.bin
  48.  
  49.    RESIDES.  iF YOU HAVE RENAMED  YOUR BASEFILE, ANY
  50.  
  51.    VALID FILE NAME CAN BE USED AS LONG AS THE FORMAT
  52.  
  53.    OF  THE  DATA  FILE  IS  CORRECT   (HAVING   BEEN
  54.  
  55.    GENERATED WITH roots89).
  56.  
  57.    
  58.  
  59.    uSE  THE  PROCEDURE  DESCRIBED ABOVE FOR THE cp/m
  60.  
  61.    VERSION OF cleanup.  a TYPICAL  COMMAND  TO START
  62.  
  63.    THE UTILITY MIGHT BE:
  64.  
  65.    
  66.  
  67.                    b:cleanup c:jones.bin
  68.  
  69.    
  70.  
  71.    aFTER THE UTILITY HAS COMPLETED ITS  ASSIGNMENT--
  72.  
  73.    WHICH  MAY  TAKE  OVER TEN MINUTES  FOR  A  LARGE
  74.  
  75.    BASEFILE--A NEW bin FILE  WILL  BE  CREATED.  tHE
  76.  
  77.    OLD  FILE  WILL  ALSO  BE ON THE  DISK  WITH  THE
  78.  
  79.    EXTENSION "bak".
  80.  
  81.    
  82.  
  83.    aS  cleanup  IS  RUNNING,  A  REPORT OF  BASEFILE
  84.  
  85.    STATUS  WILL  BE  DISPLAYED  ON  THE   COMPUTER'S
  86.  
  87.    SCREEN.
  88.  
  89.    
  90.  
  91.    
  92.  
  93.    
  94.  
  95.    wHAT cleanup DOES TO THE BASEFILE
  96.  
  97.    
  98.  
  99.    
  100.  
  101.    tHE  ROUTINE GOES THROUGH THE FOUR roots BASEFILE
  102.  
  103.    SUB-FILES IN SEQUENCE.  tHE SEQUENCE IS IMPORTANT
  104.  
  105.    BECAUSE RECORDS DELETED IN ONE SUB-FILE MAY CAUSE
  106.  
  107.    RECORDS IN A SUBSEQUENT FILE  TO  BE  DELETED.  a
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.    DELETED  MARRIAGE  MIGHT DELETE  A  SPOUSE  WHICH
  134.  
  135.    MIGHT DELETE A NAME ONLY USED BY THAT SPOUSE AND,
  136.  
  137.    FINALLY, DELETE A PLACENAME OR TWO. tHE FOLLOWING
  138.  
  139.    PARAGRAPHS DESCRIBE THE SCREENS  PERFORMED ON THE
  140.  
  141.    FOUR SUB-FILES:
  142.  
  143.    
  144.  
  145.    marriages: mARRIAGE RECORDS WILL BE RETAINED ONLY
  146.  
  147.    IF THEY CONTAIN two SPOUSES. tHUS, USERS WHO HAVE
  148.  
  149.    CREATED  A MARRIAGE RECORD  TO  DOCUMENT  THAT  A
  150.  
  151.    MARRIAGE HAS
  152.  
  153.    TAKEN PLACE ON A GIVEN DATE OR  AT A GIVEN PLACE,
  154.  
  155.    BUT WITH AN UNKNOWN PARTNER, SHOULD CREATE A "NO-
  156.  
  157.    NAME"  RECORD  FOR  THE  UNKNOWN   SPOUSE  BEFORE
  158.  
  159.    RUNNING THE UTILITY.
  160.  
  161.    
  162.  
  163.    subjects:  sUBJECT  RECORDS  WILL BE RETAINED  IF
  164.  
  165.    THEY  HAVE EITHER OR BOTH PARENTS,  IF  THEY  ARE
  166.  
  167.    REFERRED  TO BY A MARRIAGE RECORD  SURVIVING  THE
  168.  
  169.    PREVIOUS TEST, OR IF THEY ARE  REFERRED  TO  AS A
  170.  
  171.    PARENT.
  172.  
  173.    
  174.  
  175.    names:  nAME RECORDS ARE RETAINED IF REFERRED  TO
  176.  
  177.    AS ONE OF THE FIVE NAME STRINGS  FOR  ANY SUBJECT
  178.  
  179.    RECORD.
  180.  
  181.    
  182.  
  183.    placenames:  pLACE NAMES ARE RETAINED IF REFERRED
  184.  
  185.    TO BY ANY SUBJECT BIRTHPLACE OR  DEATHPLACE OR BY
  186.  
  187.    ANY MARRIAGE AS A MARRIAGE-PLACE.  sECOND  STRING
  188.  
  189.    PLACENAMES  ARE  ALSO  SAVED  WHEN  TIED  TO  ANY
  190.  
  191.    SURVIVING  FIRST STRING PLACENAME,  EVEN  IF  NOT
  192.  
  193.    DIRECTLY  REFERRED TO BY A  SUBJECT  OR  MARRIAGE
  194.  
  195.    RECORD.
  196.  
  197.    
  198.  
  199.    
  200.  
  201.    tHE UTILITY NOT ONLY DELETES RECORDS IN THE  FOUR
  202.  
  203.    SUBFILES  BUT  IT  REPACKS ALL DATA  INTO  A  NEW
  204.  
  205.    OUTPUT  FILE WITH NO GAPS. tHIS  RECOVERS  MEMORY
  206.  
  207.    SPACE  AT THE RATE OF 8 BYTES  PER  MARRIAGE,  20
  208.  
  209.    BYTES PER SUBJECT, 8 OR 16 BYTES PER NAME, AND 16
  210.  
  211.    BYTES PER PLACENAME STRING.  the  cleanup utility
  212.  
  213.    will  renumber subject records AS THEY APPEAR  IN
  214.  
  215.    THE  roots  EDITOR  IF  A SUPERFLUOUS  RECORD  IS
  216.  
  217.    DELETED.
  218.  
  219.    
  220.  
  221.    
  222.  
  223.    
  224.  
  225.    pREPARING THE bASEFILE
  226.  
  227.    
  228.  
  229.    
  230.  
  231.    bEFORE  USING cleanup, IT IS WISE TO  CHECK  YOUR
  232.  
  233.    DATA BASE FOR ENTRIES WHICH  ARE  NOT CONSISTENT.
  234.  
  235.    tHE EASIEST WAY TO CHECK FOR MULTIPLE ENTRIES  OF
  236.  
  237.    THE  SAME  FILE  IS BY USING THE  commsoft  roots
  238.  
  239.    bASEFILE pRINT uTILITY TO GENERATE A HARD COPY OF
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.    ALL DATA IN YOUR BASEFILE.  hINTS ON WHAT TO LOOK
  266.  
  267.    FOR ARE GIVEN IN THE doc FILE FOR THAT UTILITY.
  268.  
  269.