home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / FINANCE / LOAN24C.ZIP / LOANSMGR.TXT < prev    next >
Text File  |  1994-02-12  |  55KB  |  1,291 lines
  1.  
  2.                      LOANSMGR for DOS v2.4c
  3.                                by
  4.             Michael A. Campbell (campbell@metronet.com)
  5.                       Copyright 1986-1994
  6.  
  7.  
  8. 1.0  Introduction
  9.  
  10.      1.1 Program Description
  11.  
  12.      LoansMgr for DOS is a powerful but easy to use loan management
  13.      program intended for standard compound interest loans.  Common
  14.      examples of such loans are car loans and mortgages. Given any three
  15.      of the four components of the basic compound interest equation
  16.      (Loan size, Payment Size, Interest Rate, and Number of Payments),
  17.      LoansMgr will solve for the remaining one, allowing the user to run
  18.      an unlimited number of "what if" scenarios.
  19.  
  20.      In addition, LoansMgr will generate and maintain amortization
  21.      schedules, handle variable payment intervals (in units of weeks and
  22.      months), handle variable interest compounding periods per year, and
  23.      handle regularly scheduled additional principal payments. LoansMgr
  24.      also allows all data related to a given loan to be saved in a "loan
  25.      profile" file, and easily reloaded at a future date.
  26.  
  27.      1.2 System Requirements
  28.      
  29.      LoansMgr does extensive double precision floating point math, 
  30.      and runs best on PCs equipped with floating point hardware. 
  31.      However, the distribution file contains executables for both
  32.      floating point equipped PCs, and those without. See "Installation",
  33.      below.
  34.  
  35.      LoansMgr has only been tested under MS-DOS 5.0, 6.0, and 6.2. No
  36.      guarantees are made for earlier versions of MS-DOS, or DOS
  37.      implementations from other vendors. LoansMgr has been tested
  38.      successfully within a MS-Windows DOS box.
  39.  
  40.  
  41. 2.0  Acknowledgements
  42.  
  43.      I would like to acknowledge the contributions of Philip A.
  44.      Campbell, for inspiring many of LoansMgr's advanced features, and
  45.      for acting as beta tester, and to Graeme B. Boyd for 'artistic
  46.      inspiration'.
  47.  
  48.  
  49. 3.0  Legal Information
  50.  
  51. 3.1  Introduction
  52.  
  53.      PLEASE READ THIS  INFORMATION  CAREFULLY  BEFORE USING THE LOANSMGR
  54.      SOFTWARE  FOR ANY  CALCULATIONS.  BY  USING  THE SOFTWARE,  YOU
  55.      ARE  AGREEING  TO BE  BOUND  BY THE  TERMS PRESENTED HEREIN.
  56.  
  57.      I wrote the first  version of  LoansMgr  in 1985, and have been
  58.      using it ever  since to  assist in simple  financial decisions,
  59.      such as what I should be paying for my new car loan,  whether I
  60.      should  refinance my mortgage, and so on.  I have always  found it
  61.      to be very  helpful in arriving at these  decisions.  However,
  62.      LoansMgr  is not a  certified financial  program of any sort.  I am
  63.      an  engineer,  not a financier,  and so there is no  guarantee that
  64.      the  data LoansMgr generates is unconditionally correct.
  65.  
  66.      Please  understand that you use LoansMgr at your own risk.  Please
  67.      do not make financial decisions of ANY nature based solely on data
  68.      generated by  LoansMgr.  I am not aware of any bugs in LoansMgr's
  69.      financial calculation software, but that does not mean that there
  70.      are none there.  As a result of this simple  observation, what
  71.      follows is a fair amount of "legal-ese"  intended to say, in
  72.      hopefully proper legal terminology,   that  I  cannot  be  held
  73.      liable  for  any erroneous  data that  LoansMgr may  generate.
  74.      Please read this information carefully.
  75.  
  76.  
  77. 3.2  Legal Disclaimer
  78.  
  79.      BY USING  LOANSMGR,  YOU ARE  AGREEING  TO BE BOUND BY THE TERMS
  80.      PRESENTED BELOW:
  81.  
  82.      You  expressly  acknowledge  and  agree  that  use  of the LoansMgr
  83.      software   (hereafter   referred   to  as  'the Software')  is at
  84.      your sole  risk.  The  Software  and the related  documentation are
  85.      provided  AS IS  and  without warranty of any kind, express or
  86.      implied,  including,  but not limited to, the implied warranties of
  87.      merchantability and fitness for a particular purpose.
  88.  
  89.      Under  no  circumstances,   including   negligence,  shall Michael
  90.      Campbell be liable for any incidental,  special or consequential
  91.      damages   that  result  from  the  use  or inability  to use the
  92.      Software or related  documentation, even if advised of the
  93.      possibility of such damages.
  94.  
  95.  
  96. 4.0  LoansMgr Terminology
  97.  
  98. 4.1  Introduction
  99.  
  100.      LoansMgr views a loan as a logically related set of numerous
  101.      variables, referred to collectively as a "loan profile". This
  102.      section describes all of the elements of a loan profile, and what
  103.      each means and is used for. It also describes the concept of
  104.      saving and reloading loan profiles.
  105.  
  106. 4.2  Basic Loan Parameters
  107.  
  108.      The major elements of a loan profile are the four basic components
  109.      of the compound interest equation:
  110.  
  111.      L - The loan size, in dollars (no distinction between $US and $CDN).
  112.  
  113.      P - The per period payment size, again in dollars.
  114.  
  115.      I - The quoted interest rate, in percentage.
  116.  
  117.      N - The number of payment periods over which the loan is amortized.
  118.  
  119. 4.3  Advanced Loan Parameters
  120.  
  121.      In addition to the above, LoansMgr includes the following in the loan
  122.      profile:
  123.  
  124.      C   - Compounding Periods. This is the number of interest compounding
  125.            periods per year. Generally, this is 12 for US loans and
  126.            mortgages, 2 for Canadian mortgages, and 1 for most car loans.
  127.  
  128.      PI  - Payment Interval, expressed in other months or weeks. This is the
  129.            units in which the N variable (number of payments) is calibrated.
  130.            The payment interval can be any of:
  131.  
  132.            a) 1.00 month
  133.            b) 0.50 months
  134.            c) 0.25 months
  135.  
  136.            d) 4.00 weeks
  137.            e) 2.00 weeks
  138.            f) 1.00 week
  139.  
  140.      APA - Additional Principal Amount, expressed in dollars. This is the
  141.            amount of any regularly scheduled additional principal payments
  142.            that may be made on the loan.
  143.  
  144.      APP - Additional Principal Period, expressed in number of payment
  145.            intervals. This is the interval between regularly scheduled
  146.            additional principle payments.
  147.  
  148. 4.4  Loan Schedule Files
  149.  
  150.      LoansMgr will generate an amortization schedule for a given loan
  151.      profile, which includes one entry for each payment, consisting of:
  152.  
  153.      a) Payment number
  154.      b) Payment date
  155.      c) Payment size
  156.      d) Principal portion of the payment
  157.      e) Interest portion of the payment
  158.      f) Total principal paid to date
  159.      g) Total interest paid to date
  160.      h) Balance after the payment is applied
  161.  
  162.      These schedules are generated into a user-specified file, which may
  163.      then be directly viewed from within LoansMgr, or may be viewed,
  164.      printed etc., after LoansMgr has been exited.
  165.  
  166.      Loan schedule files are standard ASCII text files, and so, may be
  167.      browsed at any time with your favorite ASCII text viewer, editor,
  168.      word processor, etc.
  169.  
  170. 4.5  Loan Profile Files
  171.  
  172.      LoansMgr will allow you to save all of the data related to a loan
  173.      in a "loan profile file", which you can then reload at a later
  174.      date. This allows you to work with a given loan over a long period
  175.      of time, without having to laboriously re-enter all of the
  176.      parameters of its profile.
  177.  
  178.      Loan Profile Files are binary files, and cannot be meaningfully viewed
  179.      except via LoansMgr.
  180.  
  181.  
  182. 5.0  LoansMgr User Interface
  183.  
  184. 5.1  Introduction
  185.  
  186.      LoansMgr uses a full screen user interface, consisting of "hot key"
  187.      driven menus, and "pop up" information windows. LoansMgr does not
  188.      require or support mouse driven operations. This section describes
  189.      the two major elements of the user interface: menus and popups.
  190.  
  191. 5.2  Menus
  192.  
  193.      5.2.1 Menu Overview
  194.  
  195.      LoansMgr's full screen menus look similar to the text depiction shown 
  196.      below:
  197.  
  198.      +---------------------------------------------------------------------+
  199.      |                             Menu Title                              |
  200.      +---------------------------------------------------------------------+
  201.      |                                                                     |
  202.      |                                                                     |
  203.      |  A - First  Selection Description        Selection Data (Optional)  |
  204.      |                                                                     |
  205.      |  B - Second Selection Description        Selection Data (Optional)  |
  206.      |                                                                     |
  207.      |  C - Third  Selection Description        Selection Data (Optional)  |
  208.      |                                                                     |
  209.      |  D - Fourth Selection Description        Selection Data (Optional)  |
  210.      |                                                                     |
  211.      |  .              .                                  .                |
  212.      |                                                                     |
  213.      |  .              .                                  .                |
  214.      |                                                                     |
  215.      |  .              .                                  .                |
  216.      |                                                                     |
  217.      +---------------------------------------------------------------------+
  218.      | Command:                                                            |
  219.      +---------------------------------------------------------------------+
  220.      | Prompt/Response:                                                    |
  221.      +---------------------------------------------------------------------+
  222.  
  223.  
  224.      The screen is divided into three major areas:
  225.  
  226.      a) The Title Bar
  227.      b) The Menu Item Area
  228.      c) The I/O Area
  229.  
  230.      The title bar and I/O areas are referred to collectively as the
  231.      "Menu Outline Area". It will be helpful to remember the names of
  232.      these areas, as LoansMgr allows you to configure the display colors
  233.      used in them, via the LOANSMGR.INI file.
  234.  
  235.      5.2.2 Title Bar
  236.  
  237.      The Title Bar presents the title of the menu being displayed.
  238.  
  239.      5.2.3 Menu Item Area
  240.  
  241.      The User Menu Area presents a set of "hot key" selections,
  242.      consisting of a key to press to make the selection, a description
  243.      of the what the selection is for, and optionally, data currently
  244.      associated with the selection. When the selection key is pressed,
  245.      it is not echoed to the screen, and LoansMgr takes action on it
  246.      immediately. This is why it is referred to as a "hot key" menu
  247.      system.
  248.  
  249.      5.2.4 I/O Area
  250.  
  251.      The I/O Area provides an area in which LoansMgr can provide status
  252.      information, and calculation results, and an area in which the user
  253.      can enter loan profile data, and file names, as needed. In general,
  254.      LoansMgr reads user input from the command line, and provides
  255.      responses to the user on the Prompt/Response line. As the name
  256.      indicates, LoansMgr may also prompt for more data on this line.
  257.  
  258. 5.3  Pop Up Windows
  259.  
  260.      The user menu display areas, and the general I/O area are
  261.      sufficient for most of the LoansMgr - user interactions. However,
  262.      on occasion, LoansMgr needs to display a large volume of
  263.      information (for example, help information, or complete loan
  264.      profiles). When this type of need arises, LoansMgr presents a pop
  265.      up window with the required information. The window remains
  266.      displayed until the users hits any one key, indicating that the
  267.      information displayed has been "absorbed", and is no longer
  268.      needed. At that time, the window is removed.
  269.  
  270.      The only operations possible on popup windows is to cause them
  271.      to be displayed, and to remove them by striking a key. Popups
  272.      cannot be moved, resized, or otherwise manipulated.
  273.  
  274.  
  275. 6.0  Common Menu Behavior
  276.  
  277. 6.1  Introduction
  278.  
  279.      Not suprisingly, all of LoansMgr's menus share some identical
  280.      behavioral characteristics. This section describes elements that
  281.      are common to all menus.
  282.  
  283. 6.2  "Hot Key" Operation
  284.  
  285.      All of LoansMgr's menus are "hot key" menus. This simply means that
  286.      when a selection is made, by pressing the single key associated with
  287.      that selection, LoansMgr does not echo the selection. Instead, it
  288.      acts on it immediately, and the output resulting from the action
  289.      taken acts as the "echo" to the key press.
  290.  
  291. 6.3  Redraw Screen
  292.  
  293.      In the unlikely event that LoansMgr should mess up the screen
  294.      display (this is a *bug* if it happens - please let me know!), it can
  295.      be redrawn by hitting the "`" key, which generally is the key to the
  296.      left of the "1" key.
  297.  
  298. 6.4  The "<" and ">" Characters
  299.  
  300.      LoansMgr has a limited amount of space in which to display large
  301.      data items, such as filenames. In the event that a filename will
  302.      not fit in the available display area, LoansMgr will display
  303.      characters up to the maximum display width available, and then
  304.      output a "<" character, which indicates that there are undisplayed
  305.      characters to the left, or a ">" character, which indicates that
  306.      there are undisplayed characters to the right.
  307.  
  308. 6.5  Esc and F1
  309.  
  310.      All LoansMgr menus have "Quit" and "Help" commands. In the DOS world,
  311.      the Esc and F1 keys have become defacto standards for these functions.
  312.      As such, the Esc key may be used in place of the "Q" command, and the
  313.      F1 key can be used in place of the "H" command. Both variants of
  314.      each command operate identically.
  315.  
  316. 6.6  Error Feedback
  317.  
  318.      LoansMgr reacts to invalid menu selections with a message to that
  319.      effect, in the response line, and, optionally, an audible beeping
  320.      sound.
  321.  
  322. 6.7  "Sanity Checking"
  323.  
  324.      LoansMgr does not "sanity check" the data you enter on a given menu
  325.      until you ask it to undertake some operation with that data. At
  326.      that time, the data is checked, and the operation only undertaken
  327.      if it is "sensible". So, for example, LoansMgr will happily allow
  328.      you to enter interest rates greater than 100%, payment values that
  329.      are greater than the loan value, etc., and will only complain when
  330.      asked to compute some value using the data. At that time, LoansMgr
  331.      will present a detailed message, explaining what issue it has
  332.      detected with the data it is being asked to operate on.
  333.  
  334.      There are two exceptions to the above. The first of these is that
  335.      LoansMgr will reject any numbers which exceed 999999999999.99, as
  336.      these are clearly not "sane" values for the function that LoansMgr
  337.      was written to perform. The second is that LoansMgr will reject all
  338.      negative numbers, as these lie outside the range of meaningful
  339.      numbers for the function LoansMgr was written to perform.
  340.  
  341.  
  342.  
  343. 7.0  Main Menu
  344.  
  345. 7.1  Introduction
  346.  
  347.      When LoansMgr is first started, it presents the Main Menu. This
  348.      section describes all of the Main Menu selections.
  349.  
  350. 7.2  Selections
  351.  
  352.      L - Loan Size. This selection brings up the Loan Size Menu, which
  353.          allows you to compute the size of the loan which results from
  354.          the P, I, C, and N parameters you enter.
  355.  
  356.      P - Payment Size. This selection brings up the Payment Size Menu,
  357.          which allows you to compute the payment size needed for a loan
  358.          whose L, I, C, and N parameters you enter.
  359.  
  360.      I - Interest Rate. This selection brings up the Interest Rate Menu,
  361.          which allows you to compute the interest rate for a loan whose
  362.          L, P, C, and N parameters you enter.
  363.  
  364.      N - Number of Payments. This selection brings up the Num Payments
  365.          Menu, which allows you to calculate the number of payments
  366.          needed for a loan whose L, P, I, and C parameters you enter.
  367.  
  368.      S - Schedule. This selection brings up the Schedule Menu, which
  369.          allows you to generate loan payment schedule files for loans
  370.          whose L, P, I, and C parameters you enter.
  371.  
  372.      F - File. This selection brings up the proFile Menu, which allows
  373.          you to view the current loan profile, save it to a file, or
  374.          load a new profile from a previously saved profile file.
  375.  
  376.      A - About LoansMgr. This selection brings up the About Menu, which
  377.          allows you to view general information about LoansMgr, view an
  378.          abbreviated version of the legal disclaimers presented above,
  379.          and review the Shareware Agreement associated with use of the
  380.          program. Finally, this menu presents information on how to
  381.          contact the author, should this need arise.
  382.  
  383.      H - Help. This selection brings up a popup window containing help
  384.          for the Main Menu.
  385.  
  386.      D - DOS Shell. This selections allows you to shell out to DOS. In
  387.          order for this to work, the COMSPEC environment variable must
  388.          be set. LoansMgr will inform you of this, if it is not!
  389.  
  390.      Q - Quit. This selection quits LoansMgr, and returns to DOS. Note
  391.          that LoansMgr will not prompt you to save the loan profile, if
  392.          it has changed!
  393.  
  394. 7.3  Notes
  395.  
  396.      None
  397.  
  398.  
  399. 8.0  Loan Size Menu
  400.  
  401. 8.1  Introduction
  402.  
  403.      The Loan Size Menu allows you to compute the size of loan that
  404.      will result from the P, I, C, and N values you enter via this
  405.      menu, or that this menu inherits from either the loan profile,
  406.      or the corresponding values entered on another menu. This section
  407.      describes all of the selections for the Loan Size Menu.
  408.  
  409. 8.2  Selections
  410.  
  411.      P - Payment Size. This selection will cause LoansMgr to prompt
  412.          for the desired payment size. The value entered will be
  413.          displayed in the User Menu Area data field associated with
  414.          this selection.
  415.  
  416.      I - Interest Rate. This selection will cause LoansMgr to prompt for
  417.          the desired interest rate.  The value entered will be displayed
  418.          in the User Menu Area data field associated with this
  419.          selection.
  420.  
  421.      C - Compounding Periods. This selection will cause LoansMgr to
  422.          prompt for the number of interest compounding periods per year.
  423.          Generally, this is 12 for most US mortgages and loans, 2 for
  424.          most Canadian mortgages, and 1 for most car loans.
  425.  
  426.      N - Number of Payments. This selection will cause LoansMgr to
  427.          prompt for the desired number of payments. The value entered
  428.          will be displayed in the User Menu Area data field associated
  429.          with this selection.
  430.  
  431.      S - Solve. This selection will cause LoansMgr to solve for the loan
  432.          size, and display it on the Response Line. Other menus that
  433.          require Loan Size as a parameter will inherit the value
  434.          computed by this menu, as a starting point.
  435.  
  436.      D - DOS Shell. This selections allows you to shell out to DOS. In
  437.          order for this to work, the COMSPEC environment variable must
  438.          be set. LoansMgr will inform you of this, if it is not!
  439.  
  440.      H - Help. This selection brings up a popup window containing help
  441.          for the Loan Size Menu.
  442.  
  443.      Q - Quit. This selection quits this menu, and returns to the Main
  444.          Menu. All L, P, I, C, and N values entered or computed on this
  445.          menu will be inherited by all other menus.
  446.  
  447. 8.3  Notes
  448.  
  449.      None
  450.  
  451.  
  452. 9.0  Payment Size Menu
  453.  
  454. 9.1  Introduction
  455.  
  456.      The Payment Size Menu allows you to compute the payment size needed
  457.      for a loan whose L, I, C, and N values you enter via this menu,
  458.      or that this menu inherits from either the loan profile, or the
  459.      corresponding values entered on another menu. This section
  460.      describes all of the selections for the Payment Size Menu.
  461.  
  462. 9.2  Selections
  463.  
  464.      L - Loan Size. This selection will cause LoansMgr to prompt
  465.          for the desired loan size. The value entered will be
  466.          displayed in the User Menu Area data field associated with
  467.          this selection.
  468.  
  469.      N - Number of Payments. This selection will cause LoansMgr to
  470.          prompt for the desired number of payments. The value entered
  471.          will be displayed in the User Menu Area data field associated
  472.          with this selection.
  473.  
  474.      I - Interest Rate. This selection will cause LoansMgr to prompt for
  475.          the desired interest rate.  The value entered will be displayed
  476.          in the User Menu Area data field associated with this
  477.          selection.
  478.  
  479.      C - Compounding Periods. This selection will cause LoansMgr to
  480.          prompt for the number of interest compounding periods per year.
  481.          Generally, this is 12 for most US mortgages and loans, 2 for
  482.          most Canadian mortgages, and 1 for most car loans.
  483.  
  484.      S - Solve. This selection will cause LoansMgr to solve for the
  485.          payment size, and display it on the Response Line. Other menus
  486.          that require Payment Size as a parameter will inherit the value
  487.          computed by this menu, as a starting point.
  488.  
  489.      D - DOS Shell. This selections allows you to shell out to DOS. In
  490.          order for this to work, the COMSPEC environment variable must
  491.          be set. LoansMgr will inform you of this, if it is not!
  492.  
  493.      H - Help. This selection brings up a popup window containing help
  494.          for the Payment Size Menu.
  495.  
  496.      Q - Quit. This selection quits this menu, and returns to the Main
  497.          Menu. All L, P, I, C, and N values entered or computed on this
  498.          menu will be inherited by all other menus.
  499.  
  500. 9.3 Notes
  501.  
  502.     None
  503.  
  504.  
  505. 10.0 Interest Rate Menu
  506.  
  507. 10.1 Introduction
  508.  
  509.      The Interest Rate Menu allows you to compute the interest rate
  510.      that is needed for a loan whose L, P, C, and N parameters you
  511.      supply, or that this menu inherits from either the loan profile,
  512.      or the corresponding values entered on another menu. This section
  513.      describes all of the selections for the interest rate menu.
  514.  
  515. 10.2 Selections
  516.  
  517.      L - Loan Size. This selection will cause LoansMgr to prompt
  518.          for the desired loan size. The value entered will be
  519.          displayed in the User Menu Area data field associated with
  520.          this selection.
  521.  
  522.      P - Payment Size. This selection will cause LoansMgr to prompt
  523.          for the desired payment size. The value entered will be
  524.          displayed in the User Menu Area data field associated with
  525.          this selection.
  526.  
  527.      C - Compounding Periods. This selection will cause LoansMgr to
  528.          prompt for the number of interest compounding periods per year.
  529.          Generally, this is 12 for most US mortgages and loans, 2 for
  530.          most Canadian mortgages, and 1 for most car loans.
  531.  
  532.      N - Number of Payments. This selection will cause LoansMgr to
  533.          prompt for the desired number of payments. The value entered
  534.          will be displayed in the User Menu Area data field associated
  535.          with this selection.
  536.  
  537.      T - Payment Time. This selection will cause LoansMgr to prompt
  538.          for the interval between payments. This interval may be any
  539.          of:
  540.  
  541.            a) 1.00 Month
  542.            b) 0.50 Months
  543.            c) 0.25 Months
  544.  
  545.            d) 4.00 Weeks
  546.            e) 2.00 Weeks
  547.            f) 1.00 Week
  548.  
  549.          If you are feeling lazy, the number followed immediately by the
  550.          first letter of the unit works as well (ex: "1m" will be
  551.          interpreted as 1.00 Months).
  552.  
  553.      S - Solve. This selection will cause LoansMgr to solve for the
  554.          interest rate, and display it on the Response Line. Other menus
  555.          that require Interest Rate as a parameter will inherit the value
  556.          computed by this menu, as a starting point.
  557.  
  558.      D - DOS Shell. This selections allows you to shell out to DOS. In
  559.          order for this to work, the COMSPEC environment variable must
  560.          be set. LoansMgr will inform you of this, if it is not!
  561.  
  562.      H - Help. This selection brings up a popup window containing help
  563.          for the Interest Rate Menu.
  564.  
  565.      Q - Quit. This selection quits this menu, and returns to the Main
  566.          Menu. All L, P, I, C, and N values entered or computed on this
  567.          menu will be inherited by all other menus.
  568.  
  569. 10.3 Notes
  570.  
  571.      o The interest rate solution algorithm is knowledgeable about
  572.        compounding periods, and will display the correct interest rate
  573.        for the selected number of compounding periods.
  574.  
  575.      o Due to the nature of the mathematics involved, it is not possible
  576.        to directly solve for Interest Rate. Instead, iterative numerical
  577.        methods must be used to achieve the answer. LoansMgr uses a
  578.        proprietary iterative algorithm, which resolves the interest
  579.        rate to 2 significant digits of accuracy. Because the method is
  580.        iterative, solving for interest rate may cause an observable delay
  581.        on older, slower machines, especially those without a floating
  582.        point unit.
  583.  
  584.  
  585. 11.0 Num Payments Menu
  586.  
  587. 11.1 Introduction
  588.  
  589.      The Num Payments Menu allows you to compute the number of payments
  590.      needed for a loan whose L, P, I, and C values you enter via this
  591.      menu, or that this menu inherits from either the loan profile, or
  592.      the corresponding values entered on another menu. The number of
  593.      payments is displayed, as well as the time in years that this
  594.      number of payments represents.
  595.  
  596.      This menu also allows you to introduce regularly scheduled
  597.      principal payments, and observe the effect of these on the total
  598.      number of payments, and the calendar duration, of the loan.
  599.      Finally, this menu allows you to vary the payment interval, to
  600.      determine the impact of various payments schemes (1 per month, 2
  601.      per month, 1 per 2 weeks, etc.).
  602.  
  603.      This section describes all of the selections for the Num Payments
  604.      Menu.
  605.  
  606. 11.2 Selections
  607.  
  608.      L - Loan Size. This selection will cause LoansMgr to prompt
  609.          for the desired loan size. The value entered will be
  610.          displayed in the User Menu Area data field associated with
  611.          this selection.
  612.  
  613.      P - Payment Size. This selection will cause LoansMgr to prompt
  614.          for the desired payment size. The value entered will be
  615.          displayed in the User Menu Area data field associated with
  616.          this selection.
  617.  
  618.      I - Interest Rate. This selection will cause LoansMgr to prompt for
  619.          the desired interest rate.  The value entered will be displayed
  620.          in the User Menu Area data field associated with this
  621.          selection.
  622.  
  623.      C - Compounding Periods. This selection will cause LoansMgr to
  624.          prompt for the number of interest compounding periods per year.
  625.          Generally, this is 12 for most US mortgages and loans, 2 for
  626.          most Canadian mortgages, and 1 for most car loans.
  627.  
  628.      T - Payment Time. This selection will cause LoansMgr to prompt
  629.          for the interval between payments. This interval may be any
  630.          of:
  631.  
  632.            a) 1.00 Month
  633.            b) 0.50 Months
  634.            c) 0.25 Months
  635.  
  636.            d) 4.00 Weeks
  637.            e) 2.00 Weeks
  638.            f) 1.00 Week
  639.  
  640.          If you are feeling lazy, the number followed immediately by the
  641.          first letter of the unit works as well (ex: "1m" will be
  642.          interpreted as 1.00 Months).
  643.  
  644.      $ - Additional Principal Amount. This selection will cause LoansMgr
  645.          to prompt for the amount of the scheduled additional principal
  646.          payments. See the description of the "#" selection (immediately
  647.          below) for details on how LoansMgr uses this value. The value
  648.          entered will be displayed in the User Menu Area data field
  649.          associated with this selection.
  650.  
  651.      # - Additional Principal Period. This selection will cause LoansMgr
  652.          to prompt for the period between additional principal payments.
  653.          This period must be expressed in number of payment intervals.
  654.          The value entered will be displayed in the User Menu Area data
  655.          field associated with this selection.
  656.  
  657.          LoansMgr will then apply the amount specified via the "$"
  658.          selection against the outstanding balance, as a direct
  659.          principal injection, every 'n' payments, where 'n' is the
  660.          number you enter via this selection.
  661.  
  662.      S - Solve. This selection will cause LoansMgr to solve for the
  663.          number of payments, and display this on the Response line. Also
  664.          displayed on this line is the calendar duration, in years, of
  665.          the loan.  Other menus that require the Number of Payments as a
  666.          parameter will inherit the value computed by this menu, as a
  667.          starting point.
  668.  
  669.      D - DOS Shell. This selections allows you to shell out to DOS. In
  670.          order for this to work, the COMSPEC environment variable must
  671.          be set. LoansMgr will inform you of this, if it is not!
  672.  
  673.      H - Help. This selection brings up a popup window containing help
  674.          for the Num Payments Menu.
  675.  
  676.      Q - Quit. This selection quits this menu, and returns to the Main
  677.          Menu. All L, P, I, C, and N values entered or computed on this
  678.          menu will be inherited by all other menus.
  679.  
  680. 11.3 Notes
  681.  
  682.      None
  683.  
  684.  
  685. 12.0 Amortization Schedule Menu
  686.  
  687. 12.1 Introduction
  688.  
  689.      This menu allows you to generate and view amortization schedule
  690.      files. The selections in this menu are very similar to those in the
  691.      Num Payments menu (but will be documented below again, for
  692.      completeness), with the addition of a selection for entering the
  693.      Setup Menu, which allows titling of loans, filename selection for
  694.      schedule files, the starting date of the loan, and the number of
  695.      lines per page within the file.  This section describes all of the
  696.      selections available from this menu.
  697.  
  698.  
  699. 12.2 Selections
  700.  
  701.      L - Loan Size. This selection will cause LoansMgr to prompt
  702.          for the desired loan size. The value entered will be
  703.          displayed in the User Menu Area data field associated with
  704.          this selection.
  705.  
  706.      P - Payment Size. This selection will cause LoansMgr to prompt
  707.          for the desired payment size. The value entered will be
  708.          displayed in the User Menu Area data field associated with
  709.          this selection.
  710.  
  711.      I - Interest Rate. This selection will cause LoansMgr to prompt for
  712.          the desired interest rate.  The value entered will be displayed
  713.          in the User Menu Area data field associated with this
  714.          selection.
  715.  
  716.      C - Compounding Periods. This selection will cause LoansMgr to
  717.          prompt for the number of interest compounding periods per year.
  718.          Generally, this is 12 for most US mortgages and loans, 2 for
  719.          most Canadian mortgages, and 1 for most car loans.
  720.  
  721.      T - Payment Time. This selection will cause LoansMgr to prompt
  722.          for the interval between payments. This interval may be any
  723.          of:
  724.  
  725.            a) 1.00 Month
  726.            b) 0.50 Months
  727.            c) 0.25 Months
  728.  
  729.            d) 4.00 Weeks
  730.            e) 2.00 Weeks
  731.            f) 1.00 Week
  732.  
  733.          If you are feeling lazy, the number followed immediately by the
  734.          first letter of the unit works as well (ex: "1m" will be
  735.          interpreted as 1.00 Months).
  736.  
  737.      $ - Additional Principal Amount. This selection will cause LoansMgr
  738.          to prompt for the amount of the scheduled additional principal
  739.          payments. See the description of the "#" selection (immediately
  740.          below) for details on how LoansMgr uses this value. The value
  741.          entered will be displayed in the User Menu Area data field
  742.          associated with this selection.
  743.  
  744.      # - Additional Principal Period. This selection will cause LoansMgr
  745.          to prompt for the period between additional principal payments.
  746.          This period must be expressed in number of payment intervals.
  747.          The value entered will be displayed in the User Menu Area data
  748.          field associated with this selection.
  749.  
  750.          LoansMgr will then apply the amount specified via the "$"
  751.          selection against the outstanding balance, as a direct
  752.          principal injection, every 'n' payments, where 'n' is the
  753.          number you enter via this selection. Each such payment shows up
  754.          as a separate and distinctive entry in the schedule file.
  755.  
  756.      F - File Setup. This selection causes LoansMgr to display the Setup
  757.          Menu, which allows titling of loans, amortization filename
  758.          selection, starting date selection, and selection of the number
  759.          of lines per page in the amortization file.
  760.  
  761.      S - Schedule. This selection will cause LoansMgr to generate the
  762.          schedule of payments, and write this to the specified schedule
  763.          file name.  If a file with that name already exists, LoansMgr
  764.          will prompt regarding overwrite of this file.  The generated
  765.          schedule may then be viewed immediately, via the "V" command
  766.          (see below), or may be viewed, printed, etc., after LoansMgr
  767.          has been exited.
  768.  
  769.          After the schedule file has been written, LoansMgr generates a
  770.          popup window containing the payout summary for the loan,
  771.          showing the total principal paid, the total interest paid, the
  772.          total cost of the loan, and the number of payments the loan
  773.          required. Unlike all other popups, this window remains onscreen
  774.          until one of the parameters of the loan profile are changed, or
  775.          the Amortization Schedule Menu is exited.  
  776.  
  777.      V - View Amortization Schedule. This selection will cause LoansMgr
  778.          to invoke the ASCII file viewer of your choice (usually a text
  779.          editor) on the generated schedule file, allowing you to view it
  780.          immediately.
  781.  
  782.          To determine the file viewer to use, LoansMgr looks for an
  783.          environment variable  called EDITOR. If found, it invokes the
  784.          command contained within, with the name of the schedule file
  785.          appended. For example, if the editor of choice is elvis.exe
  786.          (the author's personal favorite), the EDITOR variable would be
  787.          set to "elvis", and LoansMgr would issue the command:
  788.  
  789.          "elvis schedule_file_name"
  790.  
  791.          in response to a "V" selection. If the EDITOR variable does not
  792.          exist, LoansMgr defaults to the standard MS-DOS TYPE command.
  793.          In this case, it alerts the user to this fact, so that they
  794.          can set the EDITOR variable if they wish.
  795.  
  796.      D - DOS Shell. This selections allows you to shell out to DOS. In
  797.          order for this to work, the COMSPEC environment variable must
  798.          be set. LoansMgr will inform you of this, if it is not!
  799.  
  800.      H - Help. This selection brings up a popup window containing help
  801.          for the Schedule Menu.
  802.  
  803.      Q - Quit. This selection quits this menu, and returns to the Main
  804.          Menu. All L, P, I, C, and N values entered or computed on this
  805.          menu will be inherited by all other menus.
  806.  
  807. 12.3 Notes
  808.  
  809.      o The L, P, I, and C values entered in this menu may not yield a loan
  810.        with a whole number of payments. In this case, LoansMgr will
  811.        round the number of payments UP to the nearest integer value,
  812.        and adjust the payment size to make up the difference. This
  813.        creates a loan with a whole number of payments, but will result
  814.        in a schedule that shows a slightly different payment value than
  815.        was originally entered. If this happens, it should not be a cause
  816.        for concern. It is "design intent".
  817.  
  818.      o LoansMgr will allow the payment interval to be set in numbers of
  819.        weeks (0.25, 0.50, and 1.00). However, LoansMgr does not yet know
  820.        how to translate week numbers into month and year values (the
  821.        author hopes to add this in a later release), and so, the "Date"
  822.        field of the schedule file shows only "--- --". Fortunately,
  823.        every 52 weeks after the first payment is guaranteed to be one
  824.        calendar year, and so the corresponding schedule file entry is
  825.        correctly marked.
  826.  
  827.      o Schedule files are simple ASCII text files, and may be viewed by
  828.        any program capable of dealing with such data.
  829.  
  830.      o When deciding upon the file viewer of choice for the "V" selection,
  831.        please be aware that v2.4 of LoansMgr occupies roughly 104K of
  832.        main memory.
  833.  
  834.      o I recommend giving schedule files the three letter extension
  835.        "sch".  Consistent use of this extension has proven to be very
  836.        beneficial for me.
  837.  
  838.  
  839. 13.0 Setup Menu
  840.  
  841. 13.1 Introduction
  842.  
  843.      This menu allows titling of loans, amortization filename selection,
  844.      starting date selection, and selection of the number of lines per
  845.      page in the amortization file.
  846.  
  847. 13.2 Selections
  848.  
  849.      N - Name of Loan. This selection causes LoansMgr to prompt for the 
  850.          name of the loan. This is a user supplied string that is printed
  851.          in the header of the amortization schedule file, allowing users
  852.          to "title" their amortization schedules with names that are 
  853.          meaningful to them. This lessens reliance on recall of what 
  854.          cryptic 8 letter file names may have stood for.
  855.  
  856.      F - Filename. This selection will cause LoansMgr to prompt for the
  857.          name of the file to which the generated amortization schedule
  858.          will be written. The filename entered is displayed (up to the
  859.          maximum allowable display width) in the User Menu Area data
  860.          field associated with this selection.
  861.  
  862.      D - Date of First Payment. This selection will cause LoansMgr to
  863.          prompt for the starting date of the first payment of the loan.
  864.          As all entries in the generated schedule are stamped with the
  865.          date, this information is critical. Dates can be entered only
  866.          in the form "MMM YY", where "MMM" is the expected "Jan" through
  867.          "Dec", and "YY" is any year from (19)70 to (20)29. Only the
  868.          last two digits will be accepted. For example, Dec 1993 would
  869.          be entered as "Dec 93".
  870.  
  871.      L - Lines Per Page. This selection will cause LoansMgr to prompt
  872.          for the number of lines per page in the amortization schedule file. 
  873.          This allows users to configure the file for the number of lines
  874.          their printer puts out on each page. LoansMgr emits formfeeds
  875.          to start each new page.
  876.  
  877.      H - Help. This selection brings up a popup window containing help
  878.          for the Setup Menu.
  879.  
  880.      Q - Quit. This selection quits this level, and returns to the 
  881.          Amortization Schedule Menu.
  882.  
  883.  
  884. 14.0 Profile Menu
  885.  
  886. 14.1 Introduction
  887.  
  888.      This menu allows you to view the current loan profile, write it to
  889.      the file of your choice, or reload a previously written profile file.
  890.      This allows you to save all the parameters relevant to a given loan,
  891.      and return to them at a later date, without having to laboriously
  892.      re-enter them. This section details all of the selections available
  893.      from the Profile Menu.
  894.  
  895. 14.2 Selections
  896.  
  897.      F - Filename. This selection will cause LoansMgr to prompt for the
  898.          name of the file name the loan profile will be written to, or
  899.          read from. The filename entered is displayed (up to the maximum
  900.          allowable display width) in the User Menu Area data field
  901.          associated with this selection.
  902.  
  903.      C - Clear. This selection causes LoansMgr to clear the current loan
  904.          profile to its default (start up) values.  This also has the
  905.          effect of removing the current profile name from the title bars
  906.          of all menus (see the Notes section, below, for more details on
  907.          this).
  908.  
  909.      R - Read. This selection will cause LoansMgr to attempt to read a
  910.          loan profile from the filename supplied via the "F"
  911.          selection. If the file does not exist, or is not a loan
  912.          profile, Loansmgr will issue an error to that effect.
  913.  
  914.      W - Write. This selection will cause LoansMgr to write the current
  915.          loan profile to the filename indicated by the "F" selection.
  916.          If a file with that name already exists, LoansMgr will prompt
  917.          regarding overwrite of this file.
  918.  
  919.      V - View. This selection will cause LoansMgr to present a popup
  920.          window containing all data that is part of the current loan
  921.          profile. This can be used to verify a profile prior to writing,
  922.          or to review a profile immediately after reading, to ensure
  923.          that the correct profile has been loaded.
  924.  
  925.      D - DOS Shell. This selections allows you to shell out to DOS. In
  926.          order for this to work, the COMSPEC environment variable must
  927.          be set. LoansMgr will inform you of this, if it is not!
  928.  
  929.      H - Help. This selection brings up a popup window containing help
  930.          for the Profile Menu.
  931.  
  932.      Q - Quit. This selection quits this menu, and returns to the Main
  933.          Menu.
  934.  
  935. 14.3 Notes
  936.  
  937.      o Loan profiles are small binary files, usually no larger than 1K
  938.        bytes.
  939.  
  940.      o I recommend giving profile files the three letter extension "prf".
  941.        Consistent use of this convention has proven to be very helpful 
  942.        to me. 
  943.  
  944.        Users should note, however, that the dBase program uses the same
  945.        extension for "printer resource files", and should be careful
  946.        to keep their loan profile files in a different directory from
  947.        their dBase files.
  948.  
  949.      o The title bar of each menu shows the name of the currently loaded
  950.        profile file, in parenthesis, as part of the menu title bar. If
  951.        no profile has been loaded or saved, this shows as "()".
  952.  
  953.      o Loan profile files can be used to conserve disk space in systems
  954.        that are low on this resource.  If you have generated a large
  955.        schedule file (example, a 30 year mortgage - 360 entries), and
  956.        wish to recover the disk space it occupies, but not lose the
  957.        data, you can write the current profile out to a file. As
  958.        mentioned above, loan profiles are small binary files, and yet
  959.        contain all the data necessary to allow LoansMgr to regenerate the
  960.        schedule file at any time. So, instead of keeping the large
  961.        schedule files on disk, keep only the profile file, and
  962.        regenerate the schedule whenever you need to view it.
  963.  
  964.  
  965. 15.0 About LoansMgr Menu
  966.  
  967. 15.1 Introduction
  968.  
  969.      This menu provides the user with a variety of information about the
  970.      LoansMgr program. The four categories of information provided are:
  971.  
  972.      a) General Program Information - typical "about" window stuff.
  973.  
  974.      b) Legal Information - important legal disclaimers that should be
  975.         read and understood prior to using LoansMgr.
  976.  
  977.      c) Shareware Information - information on your obligations as a
  978.         user of LoansMgr.
  979.  
  980.      d) Contacting The Author - information on how to contact the author
  981.         for any reason.
  982.  
  983.      This section describes all of the selections available from the
  984.      About LoansMgr menu.
  985.  
  986. 15.2 Selections
  987.  
  988.      G - General Information. This selection causes LoansMgr to present a
  989.          popup window with a variety of general "about" information for
  990.          LoansMgr, including its version number, author name, program
  991.          description, and limited acknowledgements. The window remains
  992.          displayed until you hit any single key, at which time it is
  993.          removed.
  994.  
  995.      L - Legal Disclaimers. This selection will cause LoansMgr to
  996.          present a popup window containing, essentially, a disclaimer of
  997.          all responsibility on the author's part for your use of
  998.          LoansMgr.  This same information (and more!) is presented in
  999.          the opening sections of this documentation, and should be read
  1000.          carefully and understood, prior to use of LoansMgr.  The window
  1001.          remains displayed until you hit any single key, at which time
  1002.          it is removed.
  1003.  
  1004.      S - Shareware Agreement. This selection causes LoansMgr to present
  1005.          a popup window containing information regarding the shareware
  1006.          status of LoansMgr, and your obligations regarding registration
  1007.          of the software if you decide to keep it on your system. This
  1008.          information is also presented below, in the "Shareware
  1009.          Agreement" section of this documentation.  The window remains
  1010.          displayed until you hit any single key, at which time it is
  1011.          removed.
  1012.  
  1013.      C - Contacting The Author. This selection causes Loansmgr to
  1014.          present a popup window containing information on how to reach
  1015.          the author via both electronic and surface mail. The window
  1016.          remains displayed until you hit any single key, at which time
  1017.          it is removed.
  1018.  
  1019.      Q - Quit. This selection quits this menu, and returns to the Main
  1020.          Menu.
  1021.  
  1022.  
  1023. 16.0 Installation
  1024.  
  1025.      Installing LoansMgr is easy. Start by unzipping the distribution file.
  1026.      In it, you will find two executables:
  1027.  
  1028.      a) lm_fpu.exe - this version assumes the presence of a floating
  1029.         point unit, and will not operate on a PC that does not have one.
  1030.         If run on a machine without floating point hardware, it will
  1031.         freeze the PC, and a restart will be required to recover it.
  1032.  
  1033.      b) lm_emu.exe - this version makes use of emulated floating point.
  1034.         The executable is larger, and the program is slower, as a result
  1035.         of the emulation, but this version should run on any PC.
  1036.  
  1037.      Copy one of these two (dependant on your system's hardware) to some
  1038.      directory on your PATH, and rename it to "loansmgr.exe". Copy the
  1039.      LOANSMGR.INI file to one of (a) the same directory that the EXE
  1040.      file was placed in, (b) the HOME directory (discussed below, in
  1041.      "Configuration"), or (c) the directory from which you plan to
  1042.      invoke LoansMgr.
  1043.  
  1044.      If you have a directory in which you gather all of your shareware
  1045.      documentation, copy the README.1ST and LOANSMGR.TXT files to that
  1046.      directory.
  1047.  
  1048.      Finally, it is advised that you set up an environment variable named
  1049.      "EDITOR", which contains the name of an ASCII text editor capable of
  1050.      displaying a file. If this variable does not exist, LoansMgr uses
  1051.      the internal DOS TYPE command, which is a less than graceful file
  1052.      viewer. MS-DOS systems, from Version 5.0 up, come with a credible
  1053.      full screen editor called EDIT.COM. This editor can be used for 
  1054.      this purpose if you have no other preference.
  1055.  
  1056.      That's it!
  1057.  
  1058.  
  1059. 17.0 Configuration
  1060.  
  1061. 17.1 Introduction
  1062.  
  1063.      LoansMgr can be configured in two ways:
  1064.  
  1065.      1) Environment variables
  1066.      2) The LOANSMGR.INI file
  1067.  
  1068.      This section discusses how to use these two methods to configure
  1069.      LoansMgr.
  1070.  
  1071. 17.2 Environment Variables
  1072.  
  1073.      LoansMgr uses three environment variables, and it is recommended that
  1074.      all be set before running LoansMgr for the first time. The variables
  1075.      are:
  1076.  
  1077.      COMSPEC - Like all other DOS programs, LoansMgr uses this variable
  1078.                to invoke a secondary DOS shell, when executing its DOS
  1079.                SHELL command (available from most menus). If this
  1080.                variable is not set, this command will fail.
  1081.  
  1082.      EDITOR -  This variable is used by the Amortization Schedule menu
  1083.                to determine the program to invoke to view the schedule
  1084.                file. If this variable is not set, LoansMgr defaults to
  1085.                the internal DOS TYPE command, which is a less than
  1086.                graceful viewer.
  1087.  
  1088.      HOME    - This variable is used to specify a "home" directory,
  1089.                which is generally the one in which all ".ini" type files
  1090.                reside.  If this variable is set, LoansMgr will search
  1091.                here for its LOANSMGR.INI file (see below for more
  1092.                details).
  1093.  
  1094.      Users with a unix background will recognize the unix influence in
  1095.      the existance of EDITOR and HOME variables. It will come as no
  1096.      surprise that LoansMgr started life as a unix application.
  1097.  
  1098.  
  1099. 17.3 LOANSMGR.INI File
  1100.  
  1101.      17.3.1 Introduction
  1102.  
  1103.      This file allows users to configure the colors that will be used by
  1104.      LoansMgr. Colors can be specified for the Menu Outline lines, the
  1105.      Menu Item lines, the popup windows, and the screen border.
  1106.  
  1107.      This file is a sequence of comment lines and command lines. Comment
  1108.      lines are any lines beginning with the semicolon character ";", or
  1109.      blank lines. Command lines have the form:
  1110.  
  1111.      area_name color
  1112.  
  1113.      where "area_name" is the name of a portion of the screen, and "color"
  1114.      is the color you want to set that area to.
  1115.  
  1116.  
  1117.      17.3.2 Area Names
  1118.  
  1119.      The valid area names are:
  1120.  
  1121.      menu_outline_fg - The foreground (text) color for the outline lines
  1122.      menu_outline_bg - The background color for the outline lines
  1123.  
  1124.      menu_item_fg    - The foreground (text) color for the Menu Item lines
  1125.      menu_item_bg    - The background color for the Menu Item lines
  1126.  
  1127.      popup_fg        - The foreground (text) color for the popup windows
  1128.      popup_bg        - The background color for the popup windows
  1129.  
  1130.      border_color    - The color of the screen border
  1131.  
  1132.      These names *are* case sensitive, and must be in lower case.
  1133.  
  1134.  
  1135.      17.3.3 Color Names
  1136.  
  1137.      The valid foreground colors are:
  1138.  
  1139.      BLACK,      BLUE,      GREEN,        CYAN,       RED,
  1140.      MAGENTA,    BROWN,     LIGHTGRAY,    LIGHTBLUE,  LIGHTGREEN,
  1141.      LIGHTCYAN,  LIGHTRED,  LIGHTMAGENTA, YELLOW,     WHITE
  1142.  
  1143.  
  1144.      The valid background colors are:
  1145.  
  1146.      BLACK,      BLUE,      GREEN,        CYAN,       RED,
  1147.      MAGENTA,    BROWN,     LIGHTGRAY
  1148.  
  1149.      Like the area names, these names are also case sensitive, and
  1150.      must be entered in upper case.
  1151.  
  1152.      You may specify as many or as few of these commands in the
  1153.      LOANSMGR.INI file as you wish, or you may omit this file
  1154.      altogether, in which case LoansMgr uses a default set of colors. If
  1155.      LoansMgr detects any unknown area names or color names, it discards
  1156.      all user color selections, and returns to its default color set.
  1157.      An error message is presented in the Main Menu upon completion of
  1158.      initialization.
  1159.  
  1160.  
  1161.      17.3.4 How LoansMgr Looks for LOANSMGR.INI
  1162.  
  1163.      LoansMgr follows a simple algorithm for finding the LOANSMGR.INI file.
  1164.      It searches the following directories, in the following order:
  1165.  
  1166.      a) Current Directory - This is the directory the user was in when
  1167.         LoansMgr was invoked.
  1168.  
  1169.      b) Start Up Directory - This is the directory the LoansMgr executable
  1170.         was executed from.
  1171.  
  1172.      c) HOME Directory - This is the directory indicated by the HOME
  1173.         environment variable.
  1174.  
  1175.      If LOANSMGR.INI cannot be found in any of these locations, LoansMgr
  1176.      assumes it does not exist, and uses its internal default colors.
  1177.  
  1178.  
  1179.      17.3.5 Sample LOANSMGR.INI File
  1180.  
  1181.      A sample LOANSMGR.INI file is included in the LoansMgr distribution
  1182.      zip file, and is duplicated below, as an example:
  1183.  
  1184.      ; -------------------------------------------------------------------------
  1185.      ; LoansMgr v2.4 Initialization File
  1186.      ; -------------------------------------------------------------------------
  1187.  
  1188.      ; Note that all entries *are* case sensitive
  1189.  
  1190.      ; Set the color of the menu outline lines
  1191.  
  1192.      menu_outline_fg BLACK
  1193.      menu_outline_bg RED
  1194.  
  1195.      ; Set the color of the LoansMgr menu items
  1196.  
  1197.      menu_item_fg    BLACK
  1198.      menu_item_bg    CYAN
  1199.  
  1200.      ; Set the colors for the pop up help and review windows
  1201.  
  1202.      popup_fg        WHITE
  1203.      popup_bg        BLUE
  1204.  
  1205.      ; Set up the screen border color
  1206.  
  1207.      border_color    BLUE
  1208.  
  1209.      ; --------------------------------------------------------------------
  1210.      ; End of LoansMgr v2.4 Initialization File
  1211.      ; --------------------------------------------------------------------
  1212.  
  1213.  
  1214. 18.0 Command Line Invocation
  1215.  
  1216.      The full form of the LoansMgr command line is:
  1217.  
  1218.      loansmgr [profile_file_name]
  1219.  
  1220.      where the "[" and "]" characters indicate that the profile file
  1221.      name is optional. These two characters are not entered on the
  1222.      command line itself. If a profile file name is supplied, it will
  1223.      be read and loaded in the same manner as if it had been done via
  1224.      the Profile Menu. If no profile is specified, LoansMgr uses a
  1225.      default nil profile.
  1226.  
  1227.      Example: To invoke LoansMgr using loan profile file myprof.prf, enter:
  1228.  
  1229.               loansmgr myprof.prf
  1230.  
  1231.  
  1232.      Example: To invoke LoansMgr with no profile specified, enter:
  1233.  
  1234.               loansmgr
  1235.  
  1236.  
  1237. 19.0 Shareware Agreement
  1238.  
  1239.      LoansMgr is inexpensive shareware.  You may examine it for up to 30
  1240.      days at no  expense.  If you like  LoansMgr,  and decide to keep
  1241.      it, you are  obligated to send $US 10.00 or $CDN 15.00, to:
  1242.  
  1243.      LoansMgr Registration,
  1244.      c/o Michael Campbell,
  1245.      7021 Stoddard Lane,
  1246.      Plano, Texas, USA 75025
  1247.  
  1248.      A registration form is provided with the LoansMgr zip file.
  1249.  
  1250.  
  1251. 20.0 Licensing Agreement
  1252.  
  1253.      The software accompanying this document (the Software) and the
  1254.      related  documentation  are licensed to you by Michael Campbell
  1255.      (the author), at the above stated fees.  Although the Software is
  1256.      shareware,  it is not  public  domain.  The  software contains
  1257.      copyrighted material  and  other  proprietary material.  In  order
  1258.      to  protect them,  and  except  as permitted   by   applicable
  1259.      legislation, you  may  not decompile,  reverse-engineer,
  1260.      disassemble  or otherwise reduce the Software to a human
  1261.      perceivable  form.  You may not sell the Software, and you may not
  1262.      bundle the Software with other  commercial  products, without  the
  1263.      author's express written permission.  You may, however, include the
  1264.      Software on a CD-ROM or floppy  collection, provided  the original
  1265.      package is included in its entirety.
  1266.  
  1267.  
  1268. 21.0 Contacting The Author
  1269.  
  1270.      If you should wish to reach me for any reason, including, but not
  1271.      limited to:
  1272.  
  1273.      a) Bug reports
  1274.  
  1275.      b) Requests for new features
  1276.  
  1277.      c) Request for modifications/additions to existing features
  1278.  
  1279.      d) Gratuitous praise!  :-)
  1280.  
  1281.      I can be reached via Internet email at:
  1282.  
  1283.         campbell@metronet.com
  1284.  
  1285.      or via good old surface mail, at:
  1286.  
  1287.         Michael Campbell,
  1288.         7021 Stoddard Lane,
  1289.         Plano, Tx. USA 75025
  1290.  
  1291.