home *** CD-ROM | disk | FTP | other *** search
/ Colossal Cookbook / ColossalCookbook.cdr / diet / 903 / vita.doc < prev   
Text File  |  1988-08-21  |  68KB  |  2,113 lines

  1.        VITACAL                                                       VITACAL
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                    V I T A C A L
  11.  
  12.                      YOUR
  13.                           COMPLETE
  14.                                   VITAMIN
  15.                                          MINERAL 
  16.                                                 AND
  17.                                                    CALORIE
  18.                                                           TRACKER
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.           VITACAL  is  a  User  Supported  program.   The concept of User
  31.           Supported software affords you an opportunity to  have  quality
  32.           products  without  the  high cost of marketing.  It also allows
  33.           you to fully test the product to see if  it  meets  your  needs
  34.           before  you must commit any money.  If, after a 90 test period,
  35.           you find this program useful, please send the author the sum of
  36.           $48.95  You  may  freely  pass  copies  to  other  people   for
  37.           evaluation  as long as there is NO charge for the copies and it
  38.           is distributed in its entirety.
  39.  
  40.  
  41.  
  42.                        S Y S T E M   R E Q U I R E M E N T S
  43.  
  44.  
  45.            VITACAL requires an IBM PC/XT/AT or true compatible running
  46.            PC-DOS 2.0 or later.
  47.  
  48.           A  graphics adapter is required if you wish to display the data
  49.           in a graphical format,  but  is  not  required  for  any  other
  50.           action, including numerical printouts.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.        VITACAL BETA Documentation     -1-                            VITACAL
  62.  
  63.  
  64.  
  65.  
  66.  
  67.        VITACAL                                                       VITACAL
  68.  
  69.  
  70.  
  71.  
  72.                 [                  N O T I C E                   ]
  73.  
  74.                    Read the disclaimer before using the program.
  75.  
  76.                                     DISCLAIMER
  77.  
  78.           VITACAL,   including   programs,  data  and  documentation,  is
  79.           distributed  as  is,  with  no  guarantee  that  it  will  work
  80.           correctly  in  any  or all situations.  The author specifically
  81.           disclaims any and all guarantees and warranties, expressed  and
  82.           implied,  including  but  not  limited to implied warranties of
  83.           medical accuracy, marketability and fitness  for  a  particular
  84.           purpose,  with  respect to the program code or its accompanying
  85.           documentation.  In no event shall the author be liable for  any
  86.           medical problem, loss of profit or any other damage, commercial
  87.           or   otherwise,   including,   but  not  limited  to,  special,
  88.           incidental, consequential or other damages arising out  of  the
  89.           use  or  inability  to use these programs and or files, even if
  90.           the Author has been advised of the possibility of such damages,
  91.           or for any claim by any other party.  The program can and  will
  92.           make  recommendations  that  are  not  valid  in the particular
  93.           circumstances of its use: the user is responsible for verifying
  94.           the validity of any item before acting upon it in  any  manner.
  95.           The  program  can and will crash resulting in loss of data when
  96.           operated: FLIEGWEG Software and/or Rommie G Brewer shall not be
  97.           held liable or responsible  for  any  such  loss.   Should  the
  98.           program  prove defective, you (the user) assume the entire cost
  99.           of all necessary repair, servicing, or correction.  All  offers
  100.           are   subject   to  change  or  withdrawal  without  notice  or
  101.           notification of any kind.  The use of the  program  constitutes
  102.           total agreement and acceptance of this disclaimer.
  103.  
  104.  
  105.                 [                  N O T I C E                   ]
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.        VITACAL BETA Documentation     -2-                            VITACAL
  128.  
  129.  
  130.  
  131.  
  132.  
  133.        VITACAL                                                       VITACAL
  134.  
  135.  
  136.  
  137.                                    V I T A C A L
  138.                          T A B L E   O F   C O N T E N T S
  139.  
  140.           
  141.            Notice/Disclaimer ......................2
  142.            Table of Contents ......................3
  143.            Installation of VITACAL ................4
  144.              Hard Disk Users  .....................6
  145.              Floppy Disk Users  ...................7
  146.            General Intent of VITACAL ..............8
  147.            How Can VITACAL Help? ................ 10
  148.            What Does VITACAL Track? ..............11
  149.            Intended Audience .....................12
  150.            Personal Data Security ................13
  151.            General Disclaimers ...................14
  152.            How to use VITACAL ....................15
  153.              Mini Instructions
  154.            Major Program Elements ................17
  155.               VITA - central Menu ................17
  156.               REQMOD .............................17
  157.               DATIN ..............................17
  158.               ANAL ...............................17
  159.               FOODAD .............................18
  160.               DIETCON ............................18
  161.            Medical Basis of Calculations .........20
  162.  
  163.            APPENDIXES
  164.            APPENDIX A: Special Notes & Warnings ..22
  165.            APPENDIX B. Version Number Description.24
  166.            APPENDIX C: Registration ..............25
  167.            APPENDIX D: Help and Support BBS's.....26
  168.            APPENDIX E: Other Programs ............27
  169.            APPENDIX F: Files in VITACAL ..........29
  170.            APPENDIX G: Mini-Tutorial .............30
  171.           
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.        VITACAL BETA Documentation     -3-                            VITACAL
  194.  
  195.  
  196.  
  197.  
  198.  
  199.        VITACAL                                                       VITACAL
  200.  
  201.  
  202.  
  203.                                    INSTALLATION
  204.  
  205.           This  installation  discussion assumes you have the three ARCed
  206.           files that contain the programs and data files.  You  obviously
  207.           have the documentation, either in hardcopy or on a file, as you
  208.           are reading these instructions.
  209.           
  210.           What  you  need to type will be in all CAPITAL letters followed
  211.           by the symbol  <CR>.   <CR>  indicates  you  should  press  the
  212.           Carriage   Return   (or   equivalent  key)  on  your  computer.
  213.           Information on what is happening and what you should do will be
  214.           in primarily lower case, like this paragraph.
  215.  
  216.           (The  current  files,  with included programs, sizes, and dates
  217.           are listed in the Appendix.)  Each ARCed file will  expand  and
  218.           fit on a single 360k floppy disk.
  219.  
  220.           Format 7 blank disks.  
  221.  
  222.           Label  the  first  set  of three as VIT1-1.ARC, VIT1-2.ARC, and
  223.           VIT1-3.ARC.  These will hold the ARCed  programs  of  the  same
  224.           name(s).   Copy  the files to the disks of the same name.  Also
  225.           copy your deARCing program to each disk (I will assume  PKXARC,
  226.           as it is the most commonly used in my area.)
  227.  
  228.           Label the second set of four as VITACAL DISK 1, VITACAL DISK 2,
  229.           and  VITACAL DISK 3 and TEMP.  These will be the working disks.
  230.           (TEMP will be used by Floppy drive users as an interim step  to
  231.           hold the data files prior to putting them on the working disk.
  232.  
  233.           Put the disk labeled VITACAL DISK 1 in drive A:, and the disk
  234.           labeled VIT1-1.ARC (with the respective program) in Drive B:
  235.           and perform the following.
  236.  
  237.                  A: <CR>
  238.                  B:PKXARC B:VIT1-1 <CR>
  239.  
  240.           This will extract the programs to Disk 1.
  241.  
  242.  
  243.           Put  the  disk labeled VITACAL DISK 2 in drive A:, and the disk
  244.           labeled VIT1-2.ARC (with the respective program)  in  Drive  B:
  245.           and perform the following.
  246.  
  247.                  A: <CR>
  248.                  B:PKXARC B:VIT1-2 <CR>
  249.  
  250.  
  251.           Put  the  disk  labeled  VITACAL  DISK  3 (TEMP for dual floppy
  252.           users) in drive A:, and the disk labeled VIT1-3.ARC  (with  the
  253.           respective program) in Drive B: and perform the following.
  254.  
  255.                  A: <CR>
  256.                  B:PKXARC B:VIT1-3 <CR>
  257.  
  258.  
  259.        VITACAL BETA Documentation     -4-                            VITACAL
  260.  
  261.  
  262.  
  263.  
  264.  
  265.        VITACAL                                                       VITACAL
  266.  
  267.  
  268.           
  269.           Once  the programs and data files are extracted, proceed to the
  270.           section below that meets the way you will be using the program.
  271.  
  272.           Failure  to  run  the  configuration program is the most common
  273.           problem from my  BETA  testers,  therefore  you  will  see  the
  274.           following note all over the place.
  275.  
  276.           +-----------------------------------------------------------+
  277.           |                                                           |
  278.           |                       *** NOTE: ***                       |
  279.           |                                                           |
  280.           |         You MUST run the configuration program            |
  281.           |         the first time you run VITACAL to tell            |
  282.           |         the programs where the data is located.           |
  283.           |         Otherwise the programs will not run.              |
  284.           |                                                           |
  285.           +-----------------------------------------------------------+
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.        VITACAL BETA Documentation     -5-                            VITACAL
  326.  
  327.  
  328.  
  329.  
  330.  
  331.        VITACAL                                                       VITACAL
  332.  
  333.  
  334.                                +------------------+
  335.                                |  HARD DISK USERS |
  336.                                +------------------+
  337.           
  338.                        (drive  C: assumed for instructions)
  339.  
  340.           Put VITACAL DISK 1 in drive A:
  341.  
  342.                  C: <CR>
  343.                  MD VITACAL <CR>
  344.                  CD VITACAL <CR>
  345.                  COPY A:*.* <CR>
  346.  
  347.           Put VITACAL DISK 2 in drive A:
  348.  
  349.                  COPY A:*.* <CR>
  350.  
  351.           Put VITACAL DISK 3 in drive A:
  352.  
  353.                  MD FOD <CR>
  354.                  CD FOD <CR>
  355.                  COPY A:*.DAT <CR>
  356.  
  357.                  CD.. <CR>
  358.                  MD PRS <CR>
  359.                  CD PRS <CR>
  360.                  COPY A:*.PRS <CR>
  361.  
  362.            
  363.           Your program and data file locations should be like the
  364.           following;
  365.           
  366.           SubDirectory C:\VITACAL
  367.                  DIETFIG.DAT     (Configuration data file)
  368.                  VITA.EXE
  369.                  ANAL.EXE
  370.                  FOODAD.EXE
  371.                  REQMOD.EXE
  372.                  DATIN.EXE
  373.                  DIETCON.EXE - the configuration program
  374.                                (I recommend it be moved to a separate
  375.                                 disk)
  376.           
  377.           Sub-Subdirectory  C:\VITACAL\PRS
  378.                  All files with extension   .PRS  (indicates person)
  379.                          example  DEMO.PRS
  380.                  DIETPRS.PRS - The file with names of all individuals
  381.                                  using the program on this machine
  382.  
  383.           Sub-Subdirectory  C:\VITACAL\FOD
  384.                  ACTIV.DAT - holds calorie usage for each exercise
  385.                  CATTY.DAT - Names of all the food categories
  386.                  All files with extension .DAT (indicates food category)
  387.                          example VEGGIES.DAT
  388.  
  389.  
  390.  
  391.        VITACAL BETA Documentation     -6-                            VITACAL
  392.  
  393.  
  394.  
  395.  
  396.  
  397.        VITACAL                                                       VITACAL
  398.  
  399.  
  400.                           +---------------------------+
  401.                           |  DUAL FLOPPY DRIVE SYSTEM |
  402.                           +---------------------------+
  403.  
  404.           VITACAL DISKs 1 and 2 are already ready for use.
  405.  
  406.           
  407.           Put VITACAL DISK 3 in drive A:
  408.           Put TEMP in drive B:
  409.  
  410.                  A: <CR>
  411.                  MD FOD <CR>
  412.                  CD FOD <CR>
  413.                  COPY B:*.DAT <CR>
  414.  
  415.                  CD.. <CR>
  416.                  MD PRS <CR>
  417.                  CD PRS <CR>
  418.                  COPY B:*.PRS <CR>
  419.   
  420.           Your program and data file locations should be like the
  421.           following:
  422.  
  423.  
  424.           DRIVE A:  - EXECUTABLE PROGRAMS
  425.  
  426.                  VITACAL DISK 1
  427.                          VITA.EXE
  428.                          DATIN.EXE
  429.                          DIETCON.EXE (I recommend it be on a separate
  430.                                       disk)
  431.                          DIETFIG.DAT
  432.  
  433.                  VITACAL DISK 2
  434.                          REQMOD.EXE
  435.                          ANAL.EXE
  436.                          FOODAD.EXE
  437.                          DIETFIG.DAT
  438.  
  439.                  VITACAL DISK 4  (suggested)
  440.                          DIETCON.EXE
  441.                          DIETFIG.DAT
  442.           
  443.           DRIVE B:  - DATA FILES
  444.  
  445.                  VITACAL DISK 3
  446.                  Subdirectory B:\FOD
  447.                          all files ending in extension  .DAT
  448.                  Subdirectory B:\PRS
  449.                          all files ending in extension  .PRS
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.        VITACAL BETA Documentation     -7-                            VITACAL
  458.  
  459.  
  460.  
  461.  
  462.  
  463.        VITACAL               GENERAL INTENT OF VITACAL               VITACAL
  464.  
  465.  
  466.  
  467.  
  468.           This  program  is  designed  to be used as a guide to healthier
  469.           living.  It is only designed as a general reference and  should
  470.           not  replace  consultation with medical personnel nor should it
  471.           replace careful planning of activities or dietary planning.
  472.  
  473.           People in the U.S.  have taken a dramatic turn toward healthier
  474.           living and physical conditioning.  Everyone wants to look slim,
  475.           trim,  and 21.  While the goal is good, genetics rears its ugly
  476.           head with a majority of the populace who do not naturally  have
  477.           that  slim build.  For them to look like a Cheryl Tieg involves
  478.           slave labor, starvation and malnutrition.
  479.  
  480.           Malnutrition?  In the best fed country in the world?  Yes, that
  481.           is  frequently  the  case.   In  an attempt to reduce calories,
  482.           people are reducing their food intake on an arbitrary basis and
  483.           frequently are not getting the nourishment their body needs  to
  484.           convert  from  a 500 pound blob of blubber to the 125 pound sex
  485.           object they desire to be.  Starvation  and/or  fad  diets  will
  486.           cause  an  initial  weight  loss, but not a sustained one.  Any
  487.           sudden change in diet will cause  a  weight  change:  primarily
  488.           based  on  a  change  in  the water retention in the body.  The
  489.           change may also  cause  the  body  to  be  short  on  essential
  490.           nutrients, which it will attempt to pull from its own reserves.
  491.           There  is  only a limited amount of most vitamins stored in the
  492.           body.  Once that reserve has been depleted, poor health is only
  493.           a step away.
  494.  
  495.           But  how  do  you stay healthy while reducing your weight?  You
  496.           are trying to reduce  the  calories  you  take  in  versus  the
  497.           calories you expend while maintaining a healthy diet consisting
  498.           of  the  required vitamins and minerals.  That is where VITACAL
  499.           (c) comes in.  Rather than restrict what you eat, it allows you
  500.           to plan your lifestyle around healthy  activities  and  healthy
  501.           foods that YOU ENJOY.
  502.  
  503.                          FAT or TRIM IT IS YOUR DECISION!
  504.  
  505.  
  506.           How  does  a  normal  individual  lose weight?  By burning more
  507.           calories  than  he  consumes.   While  this  statement   sounds
  508.           simplistic,  it implies MUCH, MUCH MORE than it says.  The only
  509.           parts of the body that consume calories in significant  amounts
  510.           are  the  muscles,  i.e.   the  more  muscles you have the more
  511.           calories you require to maintain a given  body  weight.   Diets
  512.           that rely primarily on reducing calorie intake to reduce weight
  513.           are effective in the short term, but very bad in the long run.
  514.  
  515.           How  can  losing  weight  in  the short term be bad in the long
  516.           term?  By simply reducing calories, it causes your body to draw
  517.           on the energy it has stored.  This energy is stored not only in
  518.           the fat cells, but in the MUSCLES  as  well.   Your  body  will
  519.           'eat'  both  fat and muscle tissue to keep you going.  When you
  520.           end your diet (as 99% of all  people  do  eventually),  whether
  521.           because  you  have  reached  the  desired weight or because you
  522.  
  523.        VITACAL BETA Documentation     -8-                            VITACAL
  524.  
  525.  
  526.  
  527.  
  528.  
  529.        VITACAL               GENERAL INTENT OF VITACAL               VITACAL
  530.  
  531.  
  532.           could not keep up the regime, you will have less muscle  tissue
  533.           than  when  you  started.   That  is, you will have less of the
  534.           primary means of burning calories.  If you  return  to  a  diet
  535.           where  previously you maintained your weight, you will start to
  536.           GAIN weight.
  537.  
  538.           Why  do  you  gain weight?  Your body will attempt to store any
  539.           excess calories.  Since less muscle means you  no  longer  have
  540.           the  means  of  burning as many calories as before, that leaves
  541.           more to be stored as FAT.  You will  go  on  the  same  calorie
  542.           reduction  plan,  etc  till  eventually you are like the little
  543.           doughboy; the bathroom scales say you are  at  the  recommended
  544.           weight,  but  you  look  like  a  little  ball of fat.  Picture
  545.           yourself, the 'ideal weight' with arms and  legs  the  size  of
  546.           pretzels  and  your  little fat gut and butt hanging out.  Now,
  547.           isn't that a pleasant thought?
  548.  
  549.           How  do  you  prevent  this  little  fat  man from taking over?
  550.           Simple, by controlling your calorie intake and increasing  your
  551.           calorie  usage.   This  will  burn  off the unsightly fat while
  552.           increasing your basic muscle tissue that will keep the fat off.
  553.           Which would you prefer, a soft fat body at the  'ideal  weight'
  554.           or a firm well proportioned body a few pounds heavier?
  555.  
  556.                         FAT or FIRM!  IT IS YOUR DECISION!
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.        VITACAL BETA Documentation     -9-                            VITACAL
  590.  
  591.  
  592.  
  593.  
  594.  
  595.        VITACAL               GENERAL INTENT OF VITACAL               VITACAL
  596.  
  597.  
  598.                                HOW CAN VITACAL HELP?
  599.  
  600.           The  program  will  analyze  your basic life-style to determine
  601.           your requirements  for  calorie  intake  and  14  vitamins  and
  602.           minerals.   While  these may not be the optimum selection, they
  603.           are based on the data  that  was  most  prevalently  available.
  604.           Daily intake of these items will be recommended in two formats;
  605.           1)  Federal  RDA  recommendations, and 2) you may also manually
  606.           substitute your own requirements for those listed in part  two,
  607.           if you disagree with the program's determinations.
  608.  
  609.           After  the basic requirements have been determined, the program
  610.           will track your compliance over a (continuing) one year period.
  611.           Each day, you will enter  your  food  intake,  activities,  and
  612.           weight  into  the file.  The program will calculate your intake
  613.           and your output and store  it  in  your  data  file.   At  your
  614.           leisure, you may have the program analyze your actions and show
  615.           you  how  you  have  been  doing.   This  is  available for any
  616.           specified period of time, with a specified  starting  date  and
  617.           ending  date.   NOTE:  While the input section will 'roll over'
  618.           the year (i.e.  will allow you to put in data from  Dec  87  to
  619.           Jan  88,  etc)  the analysis programs are not as versatile.  To
  620.           analyze this data, you would need to analyze from  '  1  to  31
  621.           Dec, then from 1 to 31 Jan separately' to get a valid picture.
  622.  
  623.  
  624.                                 DAILY WEIGHT CHECK
  625.  
  626.           While  most  diet plans recommend you weigh only once a week, I
  627.           require daily weigh-ins.  WHY?  Very simple.  Diet programs are
  628.           trying to boost your confidence in the plan by  always  showing
  629.           you  as  'losing'  weight.  The weight of a normal person, even
  630.           one involved in a true starvation diet, will go up or  down  by
  631.           2% on a daily basis just based on water retention.  By limiting
  632.           you to one weigh-in per week, they hope to show you the overall
  633.           trend  towards  a  lower weight.  This program will graphically
  634.           show you the entire time period on a day by day basis and  show
  635.           you  the  overall  trend.  (An analysis of 1 Aug to 30 Sep will
  636.           show 61 separate points over that period and allow you  to  see
  637.           the overall trend, including fluctuations.)
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.        VITACAL BETA Documentation     -10-                            VITACAL
  656.  
  657.  
  658.  
  659.  
  660.  
  661.        VITACAL               GENERAL INTENT OF VITACAL               VITACAL
  662.  
  663.  
  664.                               WHAT DOES VITACAL TRACK
  665.  
  666.            Daily Calories
  667.            Weight
  668.            Carbohydrates
  669.            Fat (G)
  670.            Protein (G)
  671.            Fiber (G)
  672.            Sodium (Mg)
  673.            Calcium (Mg)
  674.            Phosphorus (Mg)
  675.            Potassium (Mg)
  676.            Magnesium (Mg)
  677.            Iron (Mg)
  678.            VIT B1 (Mg) - Thiamine
  679.            VIT B3 (Mg) - Niacine
  680.            VIT A (IU)
  681.            VIT B2 (Mg) - Riboflavin
  682.            VIT C (Mg) - Ascorbic Acid
  683.            VIT D (IU)
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.        VITACAL BETA Documentation     -11-                            VITACAL
  722.  
  723.  
  724.  
  725.  
  726.  
  727.        VITACAL                    INTENDED AUDIENCE                  VITACAL
  728.  
  729.  
  730.  
  731.  
  732.                                  INTENDED AUDIENCE
  733.  
  734.           The  program is designed to be used in a multitude of settings:
  735.           1) by a single individual tracking his/her own actions, 2) at a
  736.           health club, or similar establishment, where the  clientele  is
  737.           allowed  to  track their activities on the club computer, or 3)
  738.           in a medical establishment tracking the  performance  of  their
  739.           patients.   Password protection for the personal data files can
  740.           be invoked to restrict the access of others, if desired; or not
  741.           used if privacy is not an issue.  While the protection level is
  742.           minimal, it is sufficient to prevent a casual user from looking
  743.           at others data without authorization.
  744.  
  745.           The  program is also configured to run on a machine with a hard
  746.           disk, or one with multiple floppy disk drives.  It assumes that
  747.           each of the 3  major  segments  (1.   programs,  2.   personnel
  748.           files,  and 3.  food data files) is stored on a different drive
  749.           and/or in different subdirectories.  On  a  hard  disk  system,
  750.           this  may  simply  be  different  sections/paths.   On a floppy
  751.           system, the programs and food files are stored on one disk, and
  752.           the personal files are stored on a separate drive.   (NOTE:  as
  753.           the food files increase in number and size, this may not always
  754.           be  possible.   It  may require the user to pare down the files
  755.           and file sizes to meet his/her needs.)
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.        VITACAL BETA Documentation     -12-                            VITACAL
  788.  
  789.  
  790.  
  791.  
  792.  
  793.        VITACAL                PERSONAL DATA SECURITY                 VITACAL
  794.  
  795.  
  796.  
  797.                               PERSONAL DATA SECURITY
  798.  
  799.           The  programs are designed to provide a small level of security
  800.           for personal data.  This is accomplished by requiring  the  use
  801.           of  a  password  in  order to access an individual's file.  The
  802.           decision to use or not use password control  is  determined  by
  803.           the  system  operator when the program is configured.  This may
  804.           be changed at any time (without affecting the  running  of  the
  805.           programs) by reconfiguring the program.
  806.  
  807.           When  an  individual  is  introduced  to  the  program,  he  is
  808.           requested to put in his personal password.   This  is  required
  809.           for  'Introduction'  whether password protection is implemented
  810.           or not.  There is  not  an  automatic  default  password.   The
  811.           password should be something that can be easily remembered, but
  812.           uncommon  enough  to not be guessed by someone playing with the
  813.           system.  (The SYSOP  can  read  and  change  anyone's  password
  814.           through the configuration program.)  This password is stored in
  815.           code  in  one  of  the files.  If 'password' is implemented, an
  816.           individual will be asked to put in the proper password whenever
  817.           they want to access the  file.   Unfortunately,  that  includes
  818.           each  time  a  person  changes  to  a  different segment of the
  819.           program (such as from analysis to putting in your  activities.)
  820.           This  was  a  necessary  embellishment  because  people tend to
  821.           forget to return the program to the 'DEMO' mode, leaving  their
  822.           personal data available for anyone to access.
  823.  
  824.           There  is  also a master password that the system operator puts
  825.           in through the configuration program that will allow access  to
  826.           any  file.   I  highly  recommend  that  it  not  be  'SECRET',
  827.           'PRIVATE', your own name (or any part of it) etc or any similar
  828.           common phrases that some unauthorized individual  might  easily
  829.           think of.
  830.  
  831.           WARNING:   The   password   protection   allows   only  minimal
  832.           protection.  Any reasonably competent hacker can break the code
  833.           in a short period.
  834.  
  835.           NOTE:  The 'person' set as the default individual also does not
  836.           require a  password.   This  is  so  the  system  can  be  left
  837.           operation  in  a demonstration mode, and has the side potential
  838.           of a single user  setting  it  up  for  personal  use  and  not
  839.           requiring continued use of a password.
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.        VITACAL BETA Documentation     -13-                            VITACAL
  854.  
  855.  
  856.  
  857.  
  858.  
  859.        VITACAL                 GENERAL DISCLAIMERS                   VITACAL
  860.  
  861.  
  862.  
  863.  
  864.                                  MEDICAL ACCURACY
  865.  
  866.           While  VITACAL has been written as an aid to healthy living, it
  867.           is not a medical diagnostic tool and is not officially approved
  868.           by any medical association.  Recommendations  and  values  have
  869.           been   determined  from  various  books  and  manuals  on  food
  870.           requirements.  While I have attempted to evaluate  the  various
  871.           data, its validity must always be in question.
  872.  
  873.           The  RDA  recommendations  are  from data distributed by the US
  874.           Dept of Health.
  875.  
  876.  
  877.                 CONSULT A DOCTOR BEFORE MAJOR CHANGES IN LIFESTYLE
  878.  
  879.           The  calculations  and  recommendations are based on an average
  880.           person with average eating habits and  activity  levels.   They
  881.           are intended only to suggest possible minor alterations in your
  882.           habits  to  improve  your  health.  Any radical changes in your
  883.           life style should only be  attempted  after  consultation  with
  884.           your doctor.
  885.  
  886.           People  who are pregnant and people who have any disease or any
  887.           health problems should not use  this  program,  as  it  is  not
  888.           designed for your special circumstances.
  889.           
  890.  
  891.  
  892.                               LACK OF PRIVACY OF DATA
  893.  
  894.           While  password  protection  has  been  designed  into the data
  895.           files,  they  are   only   MINIMUM   level   protection.    Any
  896.           semi-competent  computer  hacker could break into a program and
  897.           read the results.  It is also possible for others to accidently
  898.           break the code and read the files.
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.        VITACAL BETA Documentation     -14-                            VITACAL
  920.  
  921.  
  922.  
  923.  
  924.  
  925.        VITACAL                 GENERAL DISCLAIMERS                   VITACAL
  926.  
  927.  
  928.                          ABOUT THE AUTHOR'S QUALIFICATIONS
  929.  
  930.           I am not a doctor nor health specialist.  I have NO training in
  931.           dietary requirements nor any similar field.
  932.  
  933.           I am a 'technocrat' with a BSME and an MSIT.
  934.  
  935.           After  the  latest changes in the rules, where the USAF expects
  936.           me to look like an 18 year old, I found  myself  in  a  pickle.
  937.           How do I maintain my standards and those of the military at the
  938.           same time.  I needed a SAFE way to reduce my weight and keep my
  939.           job.
  940.  
  941.           This  program  was  the  result.   I  needed an accurate way of
  942.           tracking what I was doing and what I was  eating  and  how  the
  943.           twain would keep me in my chosen profession.  I initially tried
  944.           tracking everything with pencil and paper, and found that to be
  945.           so  time  consuming that I started skipping days.  From there I
  946.           advanced to a spreadsheet program, but found myself spending  a
  947.           lot of time looking up the same values.  This was not only very
  948.           time  consuming,  it  was  also  something  I  found  extremely
  949.           objectionable.  Once I have looked something up, I wanted it to
  950.           'stay looked up'.   As  I  am  lazy  by  nature,  this  program
  951.           resulted.
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.        VITACAL BETA Documentation     -15-                            VITACAL
  986.  
  987.  
  988.  
  989.  
  990.  
  991.        VITACAL                   HOW TO USE VITACAL                  VITACAL
  992.  
  993.  
  994.  
  995.    
  996.           +-----------------------------------------------------------+
  997.           |                                                           |
  998.           |                       *** NOTE: ***                       |
  999.           |                                                           |
  1000.           |         You MUST run the configuration program            |
  1001.           |         the first time you run VITACAL to tell            |
  1002.           |         the programs where the data is located.           |
  1003.           |         Otherwise the programs will not run.              |
  1004.           |                                                           |
  1005.           +-----------------------------------------------------------+
  1006.  
  1007.  
  1008.           The  following  will  be  a  mini  explanation  of  the various
  1009.           segments  of  VITACAL  and  what  they   will   do   for   you.
  1010.           Additionally,  it  will  give  a starting point for running the
  1011.           various program segments.
  1012.  
  1013.           The  program  segments  are  designed  to be on up to three (3)
  1014.           different drives, partitions, etc, but can  be  run  using  one
  1015.           subdirectory on a hard disk or on two floppies.  I will assume,
  1016.           for   this   explanation,   that   you   will  be  using  three
  1017.           subdirectories.  For floppy  users  (like  me),  the  food  and
  1018.           personnel  files  can  be combined on 1 disk and the Executable
  1019.           files can be on other disks to be swapped in as needed.
  1020.  
  1021.                        GENERAL NOTES COMMON TO MOST PROGRAMS
  1022.  
  1023.           In  cases  where a one character response will perform the next
  1024.           option, I have used 'hot keys.'  That is, you will not need  to
  1025.           press any key other than the one indicating your choice.  These
  1026.           keys are indicated in GREEN for users with a color monitor.  In
  1027.           other  cases, where responses exist beyond a one-key level, you
  1028.           will need to  press  a  RETURN  or  ENTER,  depending  on  your
  1029.           machine, to indicate your choice is complete.
  1030.  
  1031.           All letters are automatically translated to upper case.
  1032.  
  1033.           When  setting  the date, all input is via the arrow keys.  They
  1034.           will move you from  day  to  month  to  year,  etc  and  either
  1035.           increase or decrease the entry, depending on what you press.
  1036.  
  1037.           If  the  program  requires  data  files and you do not have the
  1038.           current version, it will tell  you.   In  selected  cases,  the
  1039.           programs will automatically return to the central menu.
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.        VITACAL BETA Documentation     -16-                            VITACAL
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.        VITACAL                   HOW TO USE VITACAL                  VITACAL
  1058.  
  1059.  
  1060.                           MAJOR PROGRAM ELEMENTS
  1061.  
  1062.           VITA.EXE
  1063.           The  Central Selection program.  From it, you can access any of
  1064.           the other programs.  Also, all other programs  have  an  option
  1065.           that will take you back to this program.
  1066.  
  1067.           REQMOD.EXE
  1068.           This  is  the  initial  program  required.   From  it,  you can
  1069.           determine your individual requirements  for  calories,  and  14
  1070.           essential vitamins and minerals.  This is also the program that
  1071.           determines  your  Basic  Metabolic  Rate  (BMR) that is used to
  1072.           determine your calorie  output  for  any  individual  activity.
  1073.           (Explanation of BMR is included in a later segment.)
  1074.  
  1075.           This  program  is  also where you 'Introduce' new people to the
  1076.           program.
  1077.  
  1078.           DATIN.EXE
  1079.           Using  this segment, you enter your daily activities and meals.
  1080.           It converts this information into data on  vitamins,  minerals,
  1081.           and calories and stores it in you personal data file.
  1082.  
  1083.           NOTE: This segment may also be used to plan your possible meals
  1084.           by  putting  in the food you are thinking about eating, but not
  1085.           storing the values.
  1086.  
  1087.           ANAL.EXE
  1088.           This  section  will allow you to analyze the data you have been
  1089.           putting into the machine and, in some cases, receive a hardcopy
  1090.           of the information.  Outputs are  in  the  form  of  a  printed
  1091.           output or displayed graphs.
  1092.  
  1093.           Printed output
  1094.           You may specify a specific time period of interest ranging from
  1095.           one  day  to  the full year.  The program will read in the data
  1096.           and print out the average  value  for  each  of  the  vitamins,
  1097.           calories,  etc,  along  with  the  recommended  RDA and program
  1098.           calculated values.  This is  on  one  sheet  of  paper  or  one
  1099.           screen.
  1100.  
  1101.              Please note that if you have neglected to enter anything for
  1102.           the  period being analyzed, those values will be averaged in as
  1103.           a zero.  While it may look good, it  is  counterproductive,  as
  1104.           you can not tell how well you really did.
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.        VITACAL BETA Documentation     -17-                            VITACAL
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.        VITACAL                   HOW TO USE VITACAL                  VITACAL
  1124.  
  1125.  
  1126.           Graphs
  1127.           For  those  with  a  graphics  capability,  there  is one other
  1128.           option: a  series  of  graphs.   After  you  specify  the  time
  1129.           increment  you are interested in, the program will plot a graph
  1130.           for each of the values specified.  (NOTE: These will  start  at
  1131.           the  first day of the start month specified and end at the last
  1132.           day of the stop month specified.  It was easier  to  label  the
  1133.           graph accurately that way.)
  1134.  
  1135.           NOTE:  If  your  computer  does not have a graphics capability,
  1136.           choosing this option will 'crash' the  program.   It  will  not
  1137.           affect the data files themselves nor the program files.
  1138.  
  1139.           FOODAD.EXE
  1140.           This  allows  you  to  add foods, modify the values of selected
  1141.           foods, and build favorite recipes and  store  them  in  a  data
  1142.           file.  NOTE: All foods and recipes are initially stored on your
  1143.           Personal items food file.  If you want them somewhere else, you
  1144.           must specifically move them.
  1145.  
  1146.           Modify A Food
  1147.           You  can  call  any  food  item in and change any or all of the
  1148.           values stored for it.  This allows  correction  of  errors  and
  1149.           updates when more detailed information becomes available.
  1150.  
  1151.           Add A Food
  1152.           Allows you to add a favorite food to the data base.  Again, you
  1153.           will  need  to  know  the vitamin/mineral contents, etc, of any
  1154.           food you want to add.
  1155.  
  1156.           Build A Recipe
  1157.           Everyone has a favorite recipe they would like to know the food
  1158.           values  of.   Well,  here is an easy way.  First, you enter the
  1159.           individual ingredients into the program, then it helps you look
  1160.           up those values in the data bases.  You then tell it  how  much
  1161.           of each ingredient you need.  After everything has been entered
  1162.           and  found,  the  program  will  ask you for a) the name of the
  1163.           food, b) the number of servings the recipe will  make,  c)  the
  1164.           number  of  pieces  in  a  serving  (for  example,  '2' cups of
  1165.           spaghetti with meat sauce), and c) the unit/size for the  above
  1166.           (example  2  'cups'  of  spaghetti.)   It  will then divide the
  1167.           number of servings per the  recipe  into  the  ingredients  and
  1168.           allow you to call up one serving whenever you want it.
  1169.  
  1170.  
  1171.    
  1172.           +-----------------------------------------------------------+
  1173.           |                                                           |
  1174.           |                       *** NOTE: ***                       |
  1175.           |                                                           |
  1176.           |         You MUST run the configuration program            |
  1177.           |         the first time you run VITACAL to tell            |
  1178.           |         the programs where the data is located.           |
  1179.           |         Otherwise the programs will not run.              |
  1180.           |                                                           |
  1181.           +-----------------------------------------------------------+
  1182.  
  1183.        VITACAL BETA Documentation     -18-                            VITACAL
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.        VITACAL                   HOW TO USE VITACAL                  VITACAL
  1190.  
  1191.  
  1192.  
  1193.           DIETCON.EXE
  1194.           Diet configuration program
  1195.  
  1196.           This  can  make radical changes to paths, personnel files, etc.
  1197.           Due to the potential damage that can occur if  an  unauthorized
  1198.           and/or  vindictive individual used it, I recommend it be stored
  1199.           in a protected segment of the disk or, preferably, on a  floppy
  1200.           that can be locked up in a separate location.
  1201.  
  1202.  
  1203.           Master Password
  1204.           Sets  a Master password that you can use to access any person's
  1205.           files when password protection is implemented.  This is  useful
  1206.           in   an  environment  when  you  occasionally  need  to  access
  1207.           someone's files but, on a normal basis,  access  to  the  files
  1208.           needs to be restricted.
  1209.  
  1210.           Use Password Protection.
  1211.           This  will  tell  the  individual  program  segments whether to
  1212.           require a password before  allowing  access  to  an  individual
  1213.           files.   The  entry  is  really on Y or other, because anything
  1214.           starting with other than a Y is taken to be NO.
  1215.  
  1216.           Path to Food Files
  1217.           Tells  the  programs  on  what  drives,  subdirectories, etc to
  1218.           search  for  the  data  files  on  food   and   calorie   usage
  1219.           equivalents.   If  they are other than the same subdirectory as
  1220.           the master programs, this must end in a \ (backslash).
  1221.  
  1222.           Path to Personnel Files
  1223.           Same as above, except it tells where files on individual people
  1224.           reside.
  1225.  
  1226.           Modify Individual Information
  1227.           This section will allow you to modify the name, data file name,
  1228.           and  password  of  any  individual having a file.  It is useful
  1229.           primarily if someone forgets their  password  or  inadvertently
  1230.           lets someone else see it.
  1231.  
  1232.    
  1233.           +-----------------------------------------------------------+
  1234.           |                                                           |
  1235.           |                       *** NOTE: ***                       |
  1236.           |                                                           |
  1237.           |         You MUST run the configuration program            |
  1238.           |         the first time you run VITACAL to tell            |
  1239.           |         the programs where the data is located.           |
  1240.           |         Otherwise the programs will not run.              |
  1241.           |                                                           |
  1242.           +-----------------------------------------------------------+
  1243.  
  1244.           
  1245.  
  1246.  
  1247.  
  1248.  
  1249.        VITACAL BETA Documentation     -19-                            VITACAL
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.        VITACAL             MEDICAL BASIS OF CALCULATIONS             VITACAL
  1256.  
  1257.  
  1258.  
  1259.            NOTE:
  1260.            ***  THIS SECTION IS BEING WRITTEN.
  1261.            ITEMS INCLUDED ARE NOTES ONLY.***
  1262.  
  1263.  
  1264.            Primary calculations of your requirements are based on the
  1265.            following data elements:
  1266.                  1)  Age
  1267.                  2)  Sex
  1268.                  3)  Height
  1269.                  4)  Weight
  1270.                  5)  Build
  1271.                  6)  Activity Level
  1272.  
  1273.            Use Metric System (Y/N)
  1274.  
  1275.  
  1276.           Proper  weight is currently determined by height and sex.  At a
  1277.           later date, I plan to use the  NIH  Body  Mass  Program.   That
  1278.           technique is listed below for comment.
  1279.  
  1280.  
  1281.           The NIH Body Mass program minimizes effect of height
  1282.  
  1283.  
  1284.                                                  2
  1285.                   pounds     /   (   height   )  
  1286.            BMI=  -------    /   (   ------     )
  1287.                   2.2      /     (   39.4     )
  1288.  
  1289.                BMI = (pounds/2.2)/((height in inches)/39.4)^2)
  1290.  
  1291.           male desirable is 22-24.  28.5 is overweight.
  1292.                                     above 33 is serious fat
  1293.  
  1294.           female desirable is 21-23.  27.5 is overweight.  
  1295.                                       31.5 is serious fat
  1296.  
  1297.  
  1298.  
  1299.           CALORIE REQUIREMENTS AND USAGE
  1300.  
  1301.           Calorie  requirements  are  based on the Resting Metabolic Rate
  1302.           (RMR).  This is the minimum  calorie  requirement  to  keep  an
  1303.           individual alive and at a constant weight if the individual was
  1304.           constantly  asleep: i.e.  no outside activity requiring caloric
  1305.           output.
  1306.  
  1307.           Calorie   output   for  given  activities  are  based  on  this
  1308.           requirement  multiplied  by  a  factor  related  to  the  given
  1309.           activity.
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.        VITACAL BETA Documentation     -20-                            VITACAL
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.        VITACAL             MEDICAL BASIS OF CALCULATIONS             VITACAL
  1322.  
  1323.  
  1324.           RMR
  1325.           Resting Metabolic Rate =
  1326.                       1kg ideal weight * 1 kcal/hour * sex factor
  1327.  
  1328.               average man    = 70kg    154 lb  Sex Factor 1.05
  1329.               average woman =  58kg    128 lb  Sex Factor 0.97
  1330.  
  1331.  
  1332.           Recommended calories per day (CALREC)
  1333.  
  1334.               RMR * kg of ideal weight *24 hour * activity factor
  1335.  
  1336.                 activity factor
  1337.                    1    sleeping  (Basic Minimum)
  1338.                    1.5  sedentary
  1339.                    1.6  light
  1340.                    1.7  moderate
  1341.                    2    strenuous
  1342.  
  1343.  
  1344.           BMR = CALREC/(24*60)
  1345.               basal (resting) cals per minute = calrec/minutes in day
  1346.  
  1347.  
  1348.           REFERENCE:
  1349.              "NUTRITION & HEALTH" by Carpenter & Calloway, pg 77-86
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.        VITACAL BETA Documentation     -21-                            VITACAL
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.        VITACAL         APPENDIX A: SPECIAL NOTES & WARNINGS          VITACAL
  1388.  
  1389.  
  1390.  
  1391.           CONFIGURE the program.
  1392.  
  1393.           COLORS and KEYS
  1394.           Where  possible,  I  attempted  to  use  'HOT KEYS'.  These are
  1395.           indicated by the color  Green.   Pressing  the  key  without  a
  1396.           Carriage  Return  will  normally  produce the indicated action.
  1397.           EXAMPLE: The Menus are set up as hot keys.
  1398.                    The <N>ext <P>revious displays will automatically
  1399.           display the indicated page when you press the N or P key.
  1400.  
  1401.           The  file  DIETFIG.DAT  must  be  located  on the same disk and
  1402.           directory as the .EXE file you are trying to  run.   Where  you
  1403.           must use several disks, as is the case with a twin floppy drive
  1404.           system,  DIETFIG.DAT  must  be  on  each disk.  When you change
  1405.           configuration, be sure  to  copy  a  current  version  to  each
  1406.           operating disk.
  1407.  
  1408.  
  1409.           GRAPHICS
  1410.           People  without  graphics capability will crash program if they
  1411.           try to draw a graph.  All other segments work without  the  use
  1412.           of graphic adapters.
  1413.  
  1414.           FOOD DATA FILES
  1415.           Do not start a food with a blank or a number.
  1416.  
  1417.  
  1418.           PATHS
  1419.           Subdirectories,  etc,  must have been made previous to entering
  1420.           the program.
  1421.  
  1422.           When you change a path:
  1423.              none of the files are copied to the new path
  1424.              You must copy or create any files you want there
  1425.  
  1426.           The  program is designed to be located in three subdirectories.
  1427.           One could be used, but it becomes cluttered and confusing, plus
  1428.           requiring a large data space.  As created, it will  work  on  a
  1429.           two  floppy  drive  system: one holding the program section and
  1430.           one holding the two data file sections.
  1431.  
  1432.  
  1433.           When you are checking the calorie input of a food,
  1434.          Five things are shown, three are changeable
  1435.          1.  The number of units in a serving (fixed)
  1436.          2.  Estimated physical size of a serving (fixed)
  1437.          3 - 5  Servings, Ounces, Grams
  1438.            The displayed values are the number in a standard serving.
  1439.            The highlighted one shows what units you are entering in.
  1440.            Move by pressing the appropriate letter, then put in the number
  1441.            of units and press <CR>
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.        VITACAL BETA Documentation     -22-                            VITACAL
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.        VITACAL         APPENDIX A: SPECIAL NOTES & WARNINGS          VITACAL
  1454.  
  1455.  
  1456.           Paging of displayed foods, etc takes place when the
  1457.           <A>bort <P>revious <N>ext   message is shown
  1458.           pressing the appropriate letter will caused paging or abort
  1459.           the entry
  1460.  
  1461.           In  most,  but  not  all,  cases,  pressing the escape key will
  1462.           return you to the previous level/entry point
  1463.  
  1464.           Also, in most cases, ^C (Control C) will terminate the program
  1465.  
  1466.           A highlighted word normally indicates that is the selected mode
  1467.  
  1468.           POSSIBLE PROBLEMS
  1469.              1.  Invalid file.  This can occur in many areas but is
  1470.           normally caused by the following.
  1471.  
  1472.           a)  Data files and Programs are different versions.
  1473.           b)  Path has not been properly set from the configuration
  1474.               program.
  1475.           c)  The proper disks are not installed to match the paths.
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.        VITACAL BETA Documentation     -23-                            VITACAL
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.        VITACAL        APPENDIX B: Version description                VITACAL
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.           VERSION 1.0A
  1526.                   ^ ^^
  1527.                   | ||__  Minor typos
  1528.                   | |
  1529.                   | |__  Changes in displays and segments
  1530.                   |
  1531.                   |__  Major Program Changes
  1532.  
  1533.           Minor Typos
  1534.           This  will  change  as  I  find  minor  errors and typos in the
  1535.           programs.  It will  have  no  affect  on  the  running  of  the
  1536.           program.
  1537.  
  1538.           Changes in Displays and Segments
  1539.           This  will  indicate  I have made modifications to displays and
  1540.           entry  formats,  and  possibly  included   additional   program
  1541.           segments.   All  data  files  and  program segments will remain
  1542.           compatible.
  1543.  
  1544.           Major Program Changes
  1545.           As  the name indicates, these are major changes.  They will not
  1546.           be  compatible  with  previous  versions.   This  may   include
  1547.           expanding  the vitamins being calculated, etc.  Where possible,
  1548.           I will include programs to convert old data files  to  the  new
  1549.           format(s).
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.        VITACAL BETA Documentation     -24-                            VITACAL
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.        VITACAL                APPENDIX C: REGISTRATION               VITACAL
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.                Send your $48.95 check or money order to the author:
  1592.  
  1593.                                   Rommie G Brewer
  1594.                                    Rt 4 Box 912
  1595.                              Sheridan, ARkansas 72150
  1596.  
  1597.  
  1598.           Please  note:  This  is  not  my  current address.  The Program
  1599.           author's job in DoD requires  frequent  moves.   As  such,  the
  1600.           above  listed  address  is  one  that  will  forward mail to me
  1601.           EVENTUALLY.  If you  have  urgent  questions,  please  see  the
  1602.           section on support boards.
  1603.  
  1604.           Any questions, problems, or other correspondence should be sent
  1605.           to  the  same address.  If you have not received a reply in two
  1606.           months, please send again.  Mail addressed to the above address
  1607.           has been known to be lost on rare occassions.
  1608.  
  1609.           Registering  (and paying) for the program will authorize you to
  1610.           get the next version for half price.  (Please specify this when
  1611.           registering a follow-on version.)
  1612.  
  1613.           Registration will also provide the author with the incentive to
  1614.           work on improving and expanding the program.
  1615.  
  1616.           If  your  current circumstances prevent you from being able pay
  1617.           the registration  fee  (for  example:  parts  of  DoD  are  not
  1618.           authorized  to  purchase  shareware  programs) write the author
  1619.           spelling out the circumstances involved and we can  attempt  to
  1620.           find a solution.
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.        VITACAL BETA Documentation     -25-                            VITACAL
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.        VITACAL             APPENDIX D: HELP & SUPPORT BBS's          VITACAL
  1652.  
  1653.  
  1654.  
  1655.             [  H O W   T O   G E T   S U P P O R T   A N D   H E L P ]
  1656.  
  1657.           If you have any suggestions as to how VITACAL and its auxiliary
  1658.           programs can be made more useful to you, please write me.  If I
  1659.           see  the  same  suggestion  from  several sources I will try to
  1660.           include that improvement in an up-date.  Also if some  part  of
  1661.           this  manual  is incomprehensible after several readings please
  1662.           let me know so I can rewrite it.
  1663.  
  1664.           Please  send  as  much information as you can about your system
  1665.           and any problem you may be having.  Be sure to  tell  me  which
  1666.           version(s)  of  my program(s) you have.  If none of the current
  1667.           versions of my programs will resolve your problem I will return
  1668.           the money you sent me when you registered it.  If you  wish  to
  1669.           speak on the telephone send me a number where you can be called
  1670.           collect  at  night.   Tell me what days and what times I should
  1671.           try to call.
  1672.  
  1673.           Once registered, you may use as many copies on as many machines
  1674.           as  you own, within your immediate organization or family.  (An
  1675.           immediate  organization  would  be  one  located  in  a  single
  1676.           building  or cluster of buildings.  If you cannot walk from one
  1677.           location to the other, I  would  not  consider  it  within  the
  1678.           immediate  organization.)   YOU  MAY  NOT ALTER THE CODE IN ANY
  1679.           WAY, AND YOU MAY NOT SELL IT FOR ANY PRICE.  NON-PROFIT  groups
  1680.           and  clubs  may  charge  a  reasonable  copy  fee up to $10.00.
  1681.           Distributors that are not  non-profit  organizations  must  not
  1682.           distribute  VITACAL in ANY manner without written permission of
  1683.           the author.  Any copy given or distributed  by  any  person  or
  1684.           organization must contain all files.
  1685.  
  1686.           Pay  BBS  Boards.   The  programs  may  be  freely  posted  for
  1687.           download, but I would appreciate a free one year membership  on
  1688.           your  board  (not to include any special services for which for
  1689.           which each use generates a fee) per 10 downloads.  This is  not
  1690.           a requirement, but is an indication that we are both sharing in
  1691.           my  effort.  Since I probably would not be in your area anyway,
  1692.           the likelyhood of my using the board is slight.
  1693.  
  1694.           These  are the primary support BBS Boards for VITACAL as of Aug
  1695.           1, 1988.  If the current date  is  vastly  different  from  the
  1696.           listed  date  of  the support board, I may no longer be in that
  1697.           area and may not be  able  to  provide  support  through  these
  1698.           BBS's.  In such case, please write me at the listed address.
  1699.  
  1700.                                   SUPPORT BOARDS
  1701.  
  1702.                           The Wild, Willing and Innocent
  1703.                                    512-692-9331
  1704.                                   San Antonio, TX
  1705.  
  1706.                                     Black Angel
  1707.                                    512-599-3830
  1708.                                   San Antonio, TX
  1709.  
  1710.  
  1711.        VITACAL BETA Documentation     -26-                            VITACAL
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.        VITACAL                APPENDIX E: OTHER PROGRAMS             VITACAL
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.           To  determine  your  proper  weight,  I recommend Weight Genie.
  1724.           Below is an extract with address for registration.
  1725.  
  1726.                                    WEIGHT GENIE
  1727.  
  1728.           "Weight  Genie"  is pure simplicity to operate.  The program is
  1729.           as friendly as you could hope for, yet  will  tell  you  things
  1730.           about  yourself  that  even  your  best  friends  wouldn't  and
  1731.           couldn't.  With three simply measurements, "Weight Genie" tells
  1732.           you how much fat you have, how over or underweight you are  and
  1733.           what your ideal weight should be.
  1734.  
  1735.           Feel  free to try "Weight Genie" out.  If you like it and would
  1736.           like to continue using it, you may  register  for  only  $20.00
  1737.           dollars.   If  you  don't  care  for  it, thanks for trying it.
  1738.           Whether you like it or not, feel free to give a copy to try  to
  1739.           anyone you think may benefit from it.
  1740.  
  1741.                         To register simply send payment to:
  1742.                           Jim Davis
  1743.                           1115 Madison St. NE, Suite 103
  1744.                           Salem, Oregon 97303
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.        VITACAL BETA Documentation     -27-                            VITACAL
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.        VITACAL                APPENDIX E: OTHER PROGRAMS             VITACAL
  1784.  
  1785.  
  1786.  
  1787.           A  fast  sorting  program  that will work with the VITACAL data
  1788.           files is SORTF by Vernon D.  Buerg.  SORTF  will  sort  on  any
  1789.           section  of  a  line,  assuming the lines end with a <CR>.  All
  1790.           VITACAL data files (except the .PRS personal files) follow this
  1791.           criteria.  VITACAL data files should be sorted  on  the  entire
  1792.           line.
  1793.  
  1794.  
  1795.           SORTF
  1796.  
  1797.           Written  by  Vernon  Buerg  for the IBM PC using DOS 2.0 and is
  1798.           supplied for personal use.  All rights reserved.
  1799.  
  1800.           Not  for  sale  or  hire.   Commercial use is prohibited.  This
  1801.           means that no fee may be charged for any copies.  Nor may SORTF
  1802.           be  included  (or  bundled)  with  other  goods  or   services.
  1803.           Exceptions may be granted upon written request only.
  1804.  
  1805.           If  you  find  SORTF  useful,  you  are  encouraged  to  make a
  1806.           contribution to defray development costs ($10 suggested).
  1807.  
  1808.           For  use  by corporations and other institutions, contact me or
  1809.           AAI Systems for a licensing agreement.
  1810.  
  1811.                  Vernon D. Buerg
  1812.                  c/o AAI Systems, Inc.
  1813.                  456 Lakeshire Drive
  1814.                  Daly City, CA 94015
  1815.  
  1816.                  RBBS: (415) 994-2944
  1817.                  CompuServe: 70007,1212
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.        VITACAL BETA Documentation     -28-                            VITACAL
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.        VITACAL        APPENDIX F: FILES                              VITACAL
  1850.  
  1851.  
  1852.  
  1853.           File Sizes by ARC program as of 20 AUG 88
  1854.  
  1855.           VIT1-1   ARC    188435      Aug 21, 1988      12:17 AM             
  1856.  
  1857.           DIETCON  EXE     98626      Aug 20, 1988      11:05 PM             
  1858.           VITA     EXE     53458      Aug 20, 1988       8:03 PM             
  1859.           DIETFIG  DAT       477      Aug 04, 1988       9:52 PM             
  1860.           REQMOD   EXE    103602      Aug 20, 1988       9:52 PM             
  1861.  
  1862.           Total Blocks: 354      Free Blocks: 101
  1863.  
  1864.  
  1865.           VIT1-2   ARC    240433      Aug 21, 1988      12:13 AM             
  1866.  
  1867.           FOODAD   EXE    114402      Aug 20, 1988       7:53 PM             
  1868.           ANAL     EXE    104690      Aug 20, 1988       8:00 PM             
  1869.           DATIN    EXE    120466      Aug 05, 1988      11:46 PM             
  1870.           DIETFIG  DAT       477      Jul 04, 1988       3:09 PM             
  1871.  
  1872.           Total Blocks: 354      Free Blocks: 20
  1873.  
  1874.  
  1875.  
  1876.           VIT1-3   ARC     55634      Aug 07, 1988       8:29 PM             
  1877.  
  1878.           various food and activity files
  1879.  
  1880.  
  1881.           VIT1-DOC ARC     62450      Aug 21, 1988      12:18 AM             
  1882.  
  1883.           VITA     DOC     64294      Aug 14, 1988      10:42 PM             
  1884.           TUTOR    DOC    102027      Aug 17, 1988      10:01 PM             
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.        VITACAL BETA Documentation     -29-                            VITACAL
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.        VITACAL             APPENDIX G: Mini-TUTORIAL                 VITACAL
  1916.  
  1917.  
  1918.  
  1919.           This  tutorial  is  intended to walk you through the first time
  1920.           you use VITACAL.  It is also a  continuing  use  tutorial.   As
  1921.           such,  it will point out the actions you need to take, in their
  1922.           correct  order,  each  time  you  use  VITACAL.   For  detailed
  1923.           instructions, see the TUTORIAL.DOC
  1924.  
  1925.           I  will  assume you have installed the program, as indicated at
  1926.           the beginning of this document, on a hard  disk  (Floppy  users
  1927.           will  be told by the program when it can not find a file and/or
  1928.           program it needs and prompted to swap disks accordingly.)
  1929.           
  1930.  
  1931.           VITA
  1932.           The central menu.  Will direct which program will be run.
  1933.   
  1934.  
  1935.           CONFIGURE THE PROGRAM.
  1936.           Tell it where the data files are located.  After telling it the
  1937.           paths  to  the  files,  I  recommend  you  use  the  option  of
  1938.           displaying the data files (before you exit this  segment).   If
  1939.           you are unable to display the files, you probably made an error
  1940.           in specifying the path(s) and will need to set them again.
  1941.  
  1942.  
  1943.  
  1944.           DETERMINE YOUR REQUIREMENTS.
  1945.           This  segment is where you introduce a new person to the system
  1946.           and  change  the  specifications  of  a  previous  person  (for
  1947.           example, your manual input of requirements).
  1948.  
  1949.           When  you  first introduce a new person to the program, it will
  1950.           ask you to put in your height, weight, age, sex, etc, and  then
  1951.           calculate  your  requirements.  Pressing the <CR> indicates you
  1952.           are finished, and the program will then build a data  file  for
  1953.           the  individual.   If  you accidently press <CR> before you are
  1954.           finished, allow the program to build the data file, then go  in
  1955.           and change the requirements.  No harm has been done.
  1956.  
  1957.           If  you  want  to see the effect of changing your values, press
  1958.           the control key and the letter K (^K) at the same time.  (K for
  1959.           calculate, as ^C is already  used  for  other  purposes).   The
  1960.           calculated requirements are displayed on the right hand side of
  1961.           the  display  screen.   The  program  automatically makes these
  1962.           calculations when you exit this segment.
  1963.  
  1964.           Manual Requirements
  1965.           If  you  disagree with any of the requirements for vitamins and
  1966.           minerals, you may go in and change them  on  the  manual  input
  1967.           display.   This will have no effect on the program, as both the
  1968.           RDA and Manual requirements are displayed for information only.
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.        VITACAL BETA Documentation     -30-                            VITACAL
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.        VITACAL             APPENDIX G: Mini-TUTORIAL                 VITACAL
  1982.  
  1983.  
  1984.           PUT IN YOUR ACTIVITIES AND MEALS
  1985.           On  a  daily basis, you will need to put in what you have eaten
  1986.           and what you have done  (2  separate  segments.)   Rather  than
  1987.           attempt  to  use  the midnight to midnight day, I recommend you
  1988.           think of it in a more logical fashion that is easier to keep up
  1989.           with, such as from one wake-up (0530 AM?)  to the next.
  1990.  
  1991.           Put  in your meals.  The program will first ask you the name of
  1992.           the food you have eaten, then the category number it  fits  in.
  1993.           The  name  is only a memory jogger as it will be displayed with
  1994.           the foods in the category once you have  input  everything  you
  1995.           have  eaten.   The program will automatically sort the foods by
  1996.           category and then ask you to select a food from  the  category.
  1997.           By  doing  this,  it reduces the time spent opening and closing
  1998.           files and reading in data.  Select the actual food  closest  to
  1999.           what  you  ate.  It will then allow you to put in the amount in
  2000.           Servings, Ounces, or Grams (determined by pressing the  letters
  2001.           S,  O,  G  respectively).  The actual mode will be highlighted,
  2002.           and your input will be displayed next to the appropriate value.
  2003.  
  2004.           Put in your activities
  2005.           The  program  will  ask  you  for  the activity number from the
  2006.           display, and then the time in hours and minutes  you  performed
  2007.           that  activity.  Pressing <CR> for an activity tells it you are
  2008.           finished with specific activities, and it assumes you spent the
  2009.           remainder of the time sitting at ease.  You will have a running
  2010.           display of the  time  remaining  for  the  day  and  the  total
  2011.           calories   used   as  you  put  in  the  data.   Note:  If  you
  2012.           accidentally put in too much time  for  an  activity,  you  can
  2013.           change  it  by  putting in the same activity and a negative (-)
  2014.           time.
  2015.  
  2016.  
  2017.  
  2018.           ANALYZE THE RESULTS
  2019.           You  may  analyze  the results of what you have been putting in
  2020.           and how well your diet plan is  working.   You  will  have  the
  2021.           option of selecting a single day or a range of days and getting
  2022.           the  average  of what you have done and consumed.  Please don't
  2023.           put the starting day after the ending day, as you will  confuse
  2024.           the  program with unpredictable results.  Note also that if you
  2025.           did not put in any data for a  given  day,  that  day  will  be
  2026.           averaged  as  a zero (0), distorting the results.  A paper copy
  2027.           of your results is available.
  2028.  
  2029.           The  primary  means  of  seeing what you have done is available
  2030.           only to systems with graphics capability.  Select the range  of
  2031.           days  and  the  values you want to analyze and the program will
  2032.           draw a graph with each day marked.  (NOTE: It works on a  month
  2033.           by month basis, so only the month selected is important.)  Each
  2034.           value  (calories,  weight,  vitamins)  will  be  displayed on a
  2035.           separate graph.  There is NO paper  copy  capability  for  this
  2036.           data display, unfortunately.
  2037.  
  2038.  
  2039.  
  2040.  
  2041.        VITACAL BETA Documentation     -31-                            VITACAL
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.        VITACAL             APPENDIX G: Mini-TUTORIAL                 VITACAL
  2048.  
  2049.  
  2050.           ADD/MODIFY FOODS
  2051.           This  is  where  you can add your favorite foods to a category,
  2052.           and move foods from one category to another.  (I recommend  you
  2053.           put  your most commonly eaten foods into your personal category
  2054.           for ease and speed of access.)  You will be  asked  to  specify
  2055.           the  category,  then  the food.  A display (similar to that for
  2056.           modifying your requirements) will  come  up  with  the  various
  2057.           categories  of  calories,  vitamins,  etc,  for you to fill in.
  2058.           Leaving either the ounces or grams value blank will  cause  the
  2059.           program  to  calculate  the  missing one.  Putting both in will
  2060.           have the grams converted to the ounces equivalent.  It  assumes
  2061.           you are putting in one serving, and provides you a place to put
  2062.           a  serving  type  indicator.   (The  HELP  function  is not yet
  2063.           incorporated, but will be out in later versions <I HOPE>.)
  2064.  
  2065.           You  may  also  build  a  recipe  by  putting  in  the  various
  2066.           ingredients, then specifying a serving  size.   (It  looks  and
  2067.           works  very  similar  to the method used to put in your meals.)
  2068.           It calculates the individual values  from  the  totals  of  the
  2069.           various  foods,  and  divides  it by the number of servings per
  2070.           recipe.
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.        VITACAL BETA Documentation     -32-                            VITACAL
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.