home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / homecook / mmconv15.zip / MMSORT.DOC < prev    next >
Text File  |  1993-09-15  |  5KB  |  136 lines

  1.  
  2.          MMSORT
  3.  
  4.  
  5.     MMSORT is intended for people who have multiple MealMaster databases.
  6. It allows efficiency in entering recipes to the appropriate database
  7. initially without manual sorting.   If combined with MMDRIVER which runs
  8. from archived MealMaster files, running multiple databases can become
  9. relatively convenient and storage efficient as well.
  10.  
  11.  
  12.  
  13.     MMSORT gives you the following display when run without parameters:
  14.  
  15.     Version 1.00 Meal-Master recipe sorter by Rodney Grantham
  16.  
  17.          Usage: MMSORT infile
  18.  
  19.  infile - contains MM format recipes to be processed
  20.  Sorting control information must be set up in the file MMSORT.PRM.
  21.  Each of up to 25 lines contains a list of associated categories.
  22.     The first category on a line will determine the filename.
  23.     Recipes with no matching categories go to XTRAmmdd.n.
  24.  
  25.  
  26.  CONFIG.SYS must have FILES=  set high enough.
  27.   Can't open recipe file:
  28.  
  29.  -----------------------------------------------------------------
  30.  
  31.     Basically, you just provide a file of MealMaster format recipes as the
  32. input to MMSORT.  The default file MMSORT.PRM can be used in sorting these
  33. recipes.  You can either modify it or define a totally new file to control
  34. processing.  If it is missing,  MMSORT will inform you.
  35.  
  36.     The first name on a line in MMSORT.PRM is used to create a file name
  37. and the file is opened.  If a file name duplicates a former one, that line
  38. will be skipped.  The file name will be qualified with .IN.  If it already
  39. exists, the program appends to it.  At the end of the run files that had
  40. data added to them are displayed with number of recipes and number of lines
  41. written.  Since MM exports with an extra space between recipes, the number
  42. of lines totals will not match.  Number of recipes should match.
  43.  
  44.  
  45.     Sample run:
  46.  
  47.  
  48. MMSORT mm.out
  49.  
  50.  
  51.  
  52.  Processing: mm.out
  53.  
  54.  
  55.  Processed: mm.out
  56.  Recipes saved: 1725
  57.   Lines read: 57168
  58.  
  59.     1056 recipes (   37063 lines) written to   XTRA0914.3 from mm.out
  60.       16 recipes (     466 lines) written to  CROCKPOT.IN from mm.out
  61.       64 recipes (    2334 lines) written to     SOUPS.IN from mm.out
  62.        1 recipes (      24 lines) written to      DOGS.IN from mm.out
  63.       19 recipes (     639 lines) written to    PASTAS.IN from mm.out
  64.      131 recipes (    4449 lines) written to  APPETIZE.IN from mm.out
  65.      204 recipes (    6013 lines) written to  PRESERVE.IN from mm.out
  66.      211 recipes (    3743 lines) written to  BEVERAGE.IN from mm.out
  67.       23 recipes (     672 lines) written to      MISC.IN from mm.out
  68.  
  69.    The matching process is not perfect.  For example the category "Rock
  70. Spring" in one recipe put the recipe in Crockpot.  'ROCK' matched with
  71. 'ROCK' in cROCKpot.
  72.  
  73.     If you were to put CHICKEN on the first line, then an APPETIZER with
  74. CHICKEN in the category line would end up in the first line group rather
  75. than the later APPETIZER category it also matched.  So ordering of category
  76. lines can affect your outcome.
  77.  
  78.     In setting up MMSORT.PRM, use plurals for category names.  This will
  79. match with either singular or plural categories.  It is not necessary to
  80. have both DESSERT and DESSERTS - DESSERTS will catch both.  Case is
  81. irrelevant.  MMSORT will upper case everything for matching purposes.
  82.  
  83.     Up to 220 characters are read in for a category line.  But you can make
  84. several smaller lines for what will end up as one file and you will
  85. then have several input files to load.  However, only 25 category lines are
  86. supported.
  87.  
  88.     Files are opened 'append'.  Repeated runs will continue to add to the
  89. same files unless they are purged or renamed.  This is unlike the behavior
  90. of most of my programs.  The XTRAmmdd.n is handled as usual with successive
  91. versions being numbered.  This supports the usage described below.
  92.  
  93.     If you have a lot of category lines, lots of files are opened
  94. simultaneously.  This may require changing your CONFIG.SYS FILES= statement
  95. to support the additional files needed.  Alternatively, you can sort the MM
  96. recipes in successive passes.  Each time you would use the XTRAmmdd.n file
  97. from the prior run as input to the next.
  98.  
  99.     If you normally run with archived recipe databases, you may find that
  100. exporting a large database and processing it severely impacts your storage.
  101. In testing, I finally realized some of the errors I was encountering were
  102. because I was down to zero available storage.
  103.  
  104.     If there are too many files for the parameters set in \CONFIG.SYS or
  105. you are out of storage, you will receive the following message on the file
  106. that exceeds the limit:
  107.  
  108. MMSORT mm.out
  109.  
  110.  Processing: mm.out
  111.  
  112.  XTRA0914.1 - couldn't open  Error 0
  113.  Possibly exceeding maximum permitted files.
  114.  Also possible that your storage is exhausted.
  115.  
  116.  
  117.  
  118.  
  119.     This should be packaged with MMCONV, MARKIT and MSGSPLIT.  Or with
  120. MMDRIVER.
  121.  
  122.  
  123.     Like MARKIT and MSGSPLIT, it is essentially a free inclusion.  If you
  124. benefit from it, register MMCONV and/or MMDRIVER.  If the utilities are
  125. particularly useful and you would like to encourage additional ones,
  126. include a little extra with your registration.
  127.  
  128.  
  129.             Rodney Grantham
  130.             770 Cranberry Trail
  131.             Roswell, GA 30076
  132.  
  133.  
  134.  
  135.  
  136.