home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / biz / misc / sharemanager / share-managerv2.3.doc < prev    next >
Encoding:
Text File  |  1993-12-21  |  13.7 KB  |  333 lines
  1. ****************************************************************************
  2. *                                                                          *
  3. *                                                                          *
  4. *                      SHARE MANAGER V2.3    (V2.04 + only)                *
  5. *                                                                          *
  6. *                        © by Ben Muller                                   *
  7. *                                                                          *
  8. *                 completed on the 30 of September 1993                    *
  9. *                                                                          *
  10. *          This program remains the copyright of Ben Muller 1993           *
  11. ****************************************************************************
  12. *                                                                          *
  13. *                    THIS PROGRAM IS SHAREWARE                             *
  14. *                                                                          *
  15. *         This program may be freely distributed as long all files         *
  16. *       remain unchanged. If you find this program useful then please      *
  17. *       support the programmer and send $10 (or more) to:                  *
  18. *                                                                          *
  19. *                 BEN MULLER                                               *
  20. *                 32 Fortescue st                                          *
  21. *                 East Fremantle W.A. 6158                                 *
  22. *                 Australia                                                *
  23. *                                                                          *
  24. *         Send bug reports, suggestions, comments etc to the above         *
  25. *       address...................................................         *
  26. ****************************************************************************
  27. *                                                                          *
  28. *       I accept no responsibility for lost or damaged data due to the     *
  29. *     use of this program. By using this program you are accepting it      *
  30. *     "as is" and at your own risk. Any information or advice in this      *
  31. *     program is only information and should not be acted upon without     *
  32. *     other advice.                                                        *
  33. *                                                                          *
  34. ****************************************************************************
  35.  
  36.  
  37. 1   INTRODUCTION
  38.  
  39.   Share-Manager is a personal share portfolio manager. If you have trouble
  40. keeping track of your shares, then this is for you. It is not however for
  41. very large portfolios with huge amounts of money involved. $10,000,000 is
  42. the limit for this little package.
  43.  
  44.   There are bound to be bugs, oversights, limitations, and any other general
  45. problems. There will however be more updates and any suggestions/criticisms
  46. from users will be helpfull.
  47.  
  48.   Since I am an Australian and this program was written for my use, I
  49. primarily wrote it for use with the Australian Stock Exchange (ASX). There
  50. may be differences between Exchanges in different countries but I have kept
  51. the program as general as possible. For this reason I have not supplied a
  52. list of listed companies on the market. If there is anything significantly
  53. different then please write to me and I will see what I can do.
  54.  
  55.   There is a limit to the number of different shares you can have. This
  56. being 200. I don't forsee anyone needing more but if you do then drop me a
  57. letter and I'll fix it. 
  58.  
  59. PLEASE NOTE : To make full use of this program you need an internal clock or
  60.               at least have the date set correctly each time you use this
  61.               program. If you don't have the date set correctly then the
  62.               graph will be useless to you.
  63.               
  64. 2   FEATURES
  65.  
  66. 2.1   Windows
  67.  
  68.   There are four main windows within SM,( Main, Industrial, Mining & Oil,
  69. Settings).
  70.   These windows display all the information on the current portfolio.
  71.  
  72.   Main Window
  73.   
  74.       This window displays the portfolio information.
  75.       
  76.   Industrial Window
  77.   
  78.       This window displays all of the industrial shares in the current
  79.     portfolio. This is where the buying and selling of shares takes place.
  80.  
  81.   Mining & Oil Window
  82.   
  83.       This is the same as the one above,however it displays the mining & oil
  84.     shares instead.
  85.  
  86.   Settings Window
  87.      
  88.       The settings are very few at the moment but will increase.
  89.       LOAD PATH : This is the path in which portfolios are looked for.
  90.       DATA PATH : This is the path in which graph data is saved.
  91.       IGNORE CAPITAL : This will ignore the capital when buying shares.
  92.       CURRENCY : At the moment it does nothing.
  93.             
  94. 2.2   Menus
  95.  
  96.   The main window menu consists of :
  97.   
  98.   PORTFOLIO  SHARES        CAPITAL   SETTINGS       HELP ME     COMPANIES
  99.  
  100.   New        Industrial    Deposit   Set Settings   What Are    Information
  101.   Open       Mining & Oil  Withdraw  Save Settings  Help ?
  102.   Save                     Clear                    Mrkt Prcls => Australia
  103.   Save As                                                         U.S.A
  104.   Delete                                                          U.K.
  105.   Print => Portfolio
  106.   About
  107.   Quit
  108.   
  109.   
  110. PORTFOLIO  
  111.   NEW          : This clears the current portfolio and starts a new one.
  112.   
  113.   OPEN         : Opens a portfolio from disk.
  114.   
  115.   SAVE         : Saves the current portfolio to disk.
  116.   
  117.   SAVE AS      : Saves the portfolio using a requester.
  118.   
  119.   DELETE       : Delete a portfolio from disk.
  120.   
  121.   PRINT        : PORTFOLIO : Print the current portfolio to hardcopy.
  122.   
  123.   ABOUT        : No help here.
  124.   
  125.   QUIT         : Non here either.
  126.   
  127.   
  128. SHARES
  129.   INDUSTRIAL   : This takes you to the industrial window, where you can buy,
  130.                  sell, delete and update shares.
  131.                  
  132.   MINING & OIL : This is the same as above.
  133.  
  134.  
  135. CAPITAL
  136.   DEPOSIT      : This deposits an amount of capital into the portfolio.
  137.   
  138.   WITHDRAW     : Withdraw capital from the portfolio.
  139.   
  140.   CLEAR        : Reset the Capital. Useful at the begining of a financial
  141.                  year.
  142.     
  143. SETTINGS
  144.   SET SETTINGS : Set settings for SM.
  145.   
  146.   SAVE SETTINGS: Save the settings.
  147.   
  148.   
  149. HELP ME
  150.   WHAT ARE     : This is a glossary of terms used.
  151.  
  152.   HELP ?       : This will turn help on. Select again to turn off.
  153.  
  154.   MARKETABLE
  155.   PARCELS      : This will show you a list of the marketable parcels in the
  156.                  three different countries given.
  157.                    
  158. COMPANIES  
  159.   INFORMATION  : This will show a list of companies and when selected
  160.                  will show thier details. The ADD gadget will add a new
  161.                  company and the DELETE gadget will delete one.
  162.                  Limit of 200.
  163.                  
  164.  
  165.   The Industrial and Mining & Oil menus are :
  166.   
  167.   PROJECT    SHARES    OPTIONS    GRAPH
  168.  
  169.   Help ?     Buy       Buy        Selected
  170.   Return     Sell      Sell
  171.              Update    Update
  172.              Delete    Exercise
  173.                        Delete
  174.   
  175. PROJECT
  176.   HELP         : Help on options etc. Select again to turn off.
  177.   
  178.   RETURN       : This will return you to the main window.
  179.   
  180.   
  181. SHARES  
  182.   BUY          : Buy shares through this option.
  183.   
  184.   SELL         : Sell shares through this option.
  185.   
  186.   UPDATE       : Update the last sale price of shares.
  187.   
  188.   DELETE       : Delete shares if you made a mistake.
  189.   
  190. OPTIONS
  191.   BUY          : Buy options through this option.
  192.   
  193.   SELL         : Sell options through this option.
  194.   
  195.   UPDATE       : Update options through this option.
  196.  
  197.   EXERCISE     : Exercise options (convert them to shares).
  198.     
  199.   DELETE       : Delete options if you made a mistake.  
  200.  
  201. GRAPH  
  202.   SELECTED     : Graph the last sale price and volume traded.
  203.  
  204.  
  205. 3    OPERATION
  206.  
  207.   The first thing you must do when starting a portfolio is to deposit some
  208. capital into it. You can't buy shares without capital, however you can
  209. ignore capital from settings. Once this is done you can enter a name for
  210. your portfolio buy clicking in the string gadget (top left).
  211.  
  212.   Now you can buy shares and options from either of the two share windows.
  213. The name of the share has to be unique unless you want it added onto existing
  214. shares. The HI and LOW values don't have to be supplied. 
  215.   The yield and P/E values are now used in calculations. There is also
  216. another field (Growth Rate) which is also used in calculations.
  217.  
  218.   The P/E,YIELD and GROWTH RATE are used to find a magic number(See WHATARE).
  219. This magic number will give you some idea of the shares worth. The magic
  220. number is a ratio of growth to earnings with dividends taken into account.
  221. If the outcome is 1 or less then the share is poor.
  222. If the outcome is from 1 to 1.5 then the share is okay.
  223. If the outcome is from 1.5 to 2 then the share is well worth a look.
  224. If the outcome is greater than 2 then don't hesitate.
  225.  
  226. This is only a guide and by no means should you invest on this alone.
  227.  
  228.   NOTE: The P/E, YIELD and GROWTH RATE values do not have to be re-entered
  229. every time. If you leave them blank the the old value will remain.
  230.         
  231.   From day to day you may update the share price and volume traded. The data
  232. is saved to a file called <share name> in a directory called SHAREDATA. The
  233. graph function uses this file to do the graphing.
  234.  
  235.   When selling a share you may sell all or some of it.
  236.  
  237.   When depositing or withdrawing capital you can enter values as follows :
  238.  
  239.       300 or 300. or 300.0 or 300.00    = 300 dollars
  240.       300.50 or 300.5                   = 300 dollars and 50 cents
  241.       .5 or .50 or 0.5                  = 50 cents
  242.  
  243.   Share prices are all in cents. Entered as follows :
  244.   
  245.       3 or 3.0 or 3.00                  = 3 cents
  246.       3.5 or 3.50                       = 3 and a half cents
  247.       .5 or 0.5 or .50                  = half a cent
  248.       
  249.   To graph a share select the share by clicking on the name and then select
  250. the graph selected option from the menu.
  251.  
  252.  
  253. 4    FUTURE UPDATES
  254.  
  255.   I still haven't increased the dollar limit to 1 billion, but I still may.
  256.  
  257.   And of course any bugs will be dealt with.
  258.  
  259.  
  260.  
  261.   Well I hope you find the program usefull and can understand the
  262. documentation, I can't !  Writing is not my strong point. That's why I
  263. included online help and a glossary of terms.
  264.  
  265. DISCLAIMER : Use this program at your own risk. I will accept no
  266. responsibility for any lost data or risky investments. This program is only
  267. suposed to help you analyse your portfolio.
  268.  
  269. BEN MULLER
  270.  
  271. TECHNICAL INFORMATION
  272.  
  273.   I wrote the program in assembler using the DEVPAC 3 assembler (the best).
  274. It is roughly 12,500 lines of code up to V2.3. I wrote all my own routines
  275. for text display (like printf), conversion routines, sort routines, math
  276. routines for using decimal places and any other routines I have forgotten.
  277. If you want the structures of the files or anything else then please write to
  278. me. There is no gaurantee of a reply, however I will try my best.
  279.  
  280. ****************************************************************************
  281. V1.0  : 07/12/92
  282.         This was the first version. I did not release it as I only used it
  283.       for my personal portfolio. It was very messy.
  284. ****************************************************************************
  285. V1.1  : 16/2/93
  286.         I fixed a few bugs and cleaned it up a bit intending to release it
  287.       but I never did. At this stage it didn't have graphs or help etc etc.
  288. ****************************************************************************
  289. V2.0  : 03/5/93
  290.         I totally rewrote it and made it V2.04 compatible only. I added ASL
  291.       requesters and V2.04 library functions. This time I really intended
  292.       to release it, but well it never happened.
  293. ****************************************************************************
  294. V2.1  : 15/08/93
  295.         I corrected some bugs I found and added the graphing function in.
  296.         I also added the print option.
  297.       This time I did release it !!!!!!
  298. ****************************************************************************
  299. V2.11 : 04/9/93
  300.         Nothing very new in this, just did some cleaning up and fixed some
  301.       bugs.
  302.         Better help display by way of windows.
  303.         New Company Information. Exchange code, class etc.
  304.         Added sort routines for alphabetical lists.
  305.         Found out that I was loosing some memory. It was occuring when using
  306.       the GadToolsLibrary functions for creating menus and visual info. I
  307.       don't know why it happens because I clean everything up on exit. I
  308.       can only conclude it has something to do with GadTools.
  309.       So you loose just over 1k of fast mem.
  310. ****************************************************************************
  311. V2.2  : 11/09/93
  312.         I rewrote the event testing routines so that it waits for signals
  313.       and not for a port. This means that you can leave several of the
  314.       windows open all of the time. It also means you can flick back to the
  315.       main window and see the changes instantly.
  316.         I am still loosing that memory!!!
  317.         Fixed some more bugs.
  318.     Made the program font sensitive.
  319.     Added the rates of return on main window.
  320.     Added the Growth to Earnings ratio.(Magic Number)
  321.     I also removed the debug hunks. This reduced the size by about 40K.
  322.       Sorry for forgetting to remove them before.
  323. ****************************************************************************
  324. V2.3  : 30/09/93
  325.         Added keyboard equivelents for gadgets.
  326.         Changed the windows from GimmeZeroZero to normal. This made the
  327.       window updating faster. 
  328.         Made the gadgets font sensitive. Forgot to do it in the last update.
  329.         Fixed a small error which occured when selling shares.
  330.     Fixed an error in the graphing routines.
  331.     Corrected the error handling. It stuffed up on certain errors.
  332. ****************************************************************************
  333.