home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / BF / BF094A.ZIP / README.DOC < prev   
Text File  |  1992-04-07  |  20KB  |  450 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                        Capital Gainz Version 3.0
  8.       Copyright 1991-92 by David Lee Cohen. All Rights Reserved.
  9.  
  10.                               Dave Cohen
  11.                                 DBLinx
  12.                             P.O. Box 12545
  13.                           RTP, NC  27709-2545
  14.                             (919)-469-5196
  15.                        CompuServe ID: 70431,132
  16.                     Internet:davec@rock.concert.net
  17.                              April 7, 1992
  18.  
  19.  
  20. READ THIS ENTIRE DOCUMENT: It contains important information!
  21.  
  22.     This is an unregistered shareware version of Capital Gainz if:
  23.  
  24.     o     It was obtained via an electronic bulletin board, on-line
  25.           service, or other electronic means.
  26.  
  27.                          or
  28.  
  29.     o     It was obtained from a shareware disk vendor, or a source
  30.           other than DBLinx and David Lee Cohen.
  31.  
  32.                          or
  33.  
  34.     o     During program sign-on the legend "shareware version" is
  35.           displayed.
  36.  
  37. Otherwise, this is a registered version of Capital Gainz, purchased by
  38. and registered to you. If this is a shareware version of Capital
  39. Gainz, after installation refer to the document LICENSE.DOC for
  40. details on the shareware version's restrictions and for information on
  41. ordering a registered version of Capital Gainz. Also included in
  42. LICENSE.DOC is a list of what you get with your Capital Gainz
  43. registration.
  44.  
  45.     Capital Gainz is distributed on one or two diskettes, containing
  46. this file, README.DOC, the INSTALL.EXE installation program, the
  47. program archive CPGNZP.zzz, and the documentation archive CPGNZD.zzz
  48. ('zzz' is 'EXE' for a self-extracting archive, or else it indicates
  49. the compression method used, such as 'ZIP'). The shareware version may
  50. also contain disk vendor information in the VENDOR.DOC file. The
  51. registered version includes the Capital Gainz Utility Program,
  52. CGUTIL.EXE, and DoublePrint, DP.EXE.
  53.  
  54.     Capital Gainz requires an IBM personal computer or compatible
  55. running MS-DOS version 3.00 or later, any monochrome or CGA/EGA/VGA
  56. monitor, a minimum of 640KB of RAM, and a hard disk. At least 512KB of
  57. RAM must be available to run Capital Gainz. The Capital Gainz User's
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Manual lists disk space requirements for the Capital Gainz data files.
  64.  
  65.     Although Capital Gainz has been reasonably tested for reliability
  66. and accuracy, you should backup your data regularly. This should
  67. especially be done before any data file upgrade. Any bugs or
  68. inaccuracies should be reported, and every effort will be made to fix
  69. them. 
  70.  
  71.    Forward bug reports, problems, questions, suggestions, or general
  72. feelings about Capital Gainz to the address at the top of this
  73. document. And thanks for trying Capital Gainz.
  74.  
  75.  
  76. Distribution, Registration:
  77. ---------------------------
  78.     Capital Gainz is Copyright 1991-92 by David Lee Cohen.
  79.  
  80.     Distribution restrictions are detailed in the VENDOR.DOC file.
  81. This software is not public domain, and failure to abide by the
  82. distribution restrictions constitutes a violation of the U.S. and
  83. International Copyright laws.
  84.  
  85.     Registration requirements are discussed in LICENSE.DOC. This file
  86. also contains a registration form, or one can be printed upon program
  87. exit.
  88.  
  89. Upgrading to a New Revision or
  90. Converting to a Registered Version
  91. -----------------------------------
  92.     If you already have a shareware or registered version of Capital
  93. Gainz installed, install the new registered version in the same
  94. directory. Only program and documentation files will be overwritten.
  95. Data files may be upgraded, but will otherwise not be affected. 
  96.  
  97.     Sometimes, a change in file formats requires an upgrade of
  98. existing data files. If this is the case, the upgrade function of the
  99. Capital Gainz Utility Program will be invoked automatically by the
  100. INSTALL program. IF YOU ARE UPGRADING, YOU SHOULD INSTALL THE NEW
  101. VERSION IN THE DIRECTORY CONTAINING THE OLD PROGRAM FILES. When
  102. attempting to run a new version of Capital Gainz against old data
  103. files that were not upgraded, you may receive the error "Can't Upgrade
  104. from Shareware Version" or "Invalid Record Declaration" when running
  105. Capital Gainz. If you experience this problem, run the Capital Gainz
  106. Utility Program to upgrade your data files.
  107.  
  108.     The Capital Gainz Utility Program is only available with the
  109. registered version of Capital Gainz. DO NOT TRY TO INSTALL A NEW
  110. UNREGISTERED VERSION ON TOP OF AN EXISTING VERSION.
  111.  
  112.  
  113.                                                                      2
  114.  
  115.  
  116.  
  117.  
  118.  
  119.     The HISTORY.DOC file contains a list of major changes between
  120. revisions of Capital Gainz. If you are upgrading from a pre-version
  121. 3.0 copy and have been maintaining multiple portfolios with DOS
  122. subdirectories, see the section on Upgrading to Version 3.0 at the end
  123. of this document.
  124.  
  125. Prepare for Installation
  126. ------------------------
  127.     You should have either two 5.25" 360KB diskettes or a single 3.5"
  128. 720KB diskette. If you have two diskettes, one should be labeled
  129. PROGRAM and one should be labeled DOC. If you have a single diskette,
  130. then it should be labeled PROGRAM. The following files should be on
  131. the diskettes - if you have a single 720KB diskette, then the PROGRAM
  132. and DOC diskettes referred to below are combined onto a single PROGRAM
  133. diskette: 
  134.  
  135.      A PROGRAM disk with INSTALL.EXE, README.DOC, and CPGNZP.zzz
  136.      ('zzz' is 'EXE' for a self-extracting archive, or else it
  137.      indicates the compression method used, such as 'ZIP').
  138.  
  139.      A DOC disk with CPGNZD.zzz ('zzz' is 'EXE' for a self-extracting
  140.      archive, or else it indicates the compression method used, such
  141.      as 'ZIP'). For registered versions, there will also be CGUTIL.EXE
  142.      and DP.EXE files. For shareware versions, there may also be a
  143.      VENDOR.DOC file, which contains information for disk vendors and
  144.      BBS sysops.
  145.  
  146.     Alternatively, INSTALL.EXE and README.DOC can be on the DOC disk
  147. instead of the PROGRAM disk. Often, Capital Gainz is archived into two
  148. files on CompuServe or bulletin boards. These two files are usually
  149. called CPGNZ.zzz and CPGNZP.zzz. The first of these two files usually
  150. contains the README.DOC, INSTALL.EXE, and VENDOR.DOC files along with
  151. the CPGNZD.zzz archive. If you downloaded these two files to your hard
  152. disk, do the following to prepare for installation:
  153.  
  154.      Unarchive the CPGNZ.zzz (or similar name) file to a temporary
  155.      directory. Then copy INSTALL.EXE, README.DOC, and CPGNZD.zzz to a
  156.      blank diskette. Next, copy CPGNZP.zzz to a different diskette. If
  157.      you have a disk drive that handles disks bigger than 360KB, you
  158.      can copy it to the same diskette as the other files.
  159.     
  160.     IF YOU DO NOT HAVE THESE FILES, PLEASE CONTACT US AT THE PHONE
  161. NUMBER OR ADDRESS LISTED AT THE TOP OF THIS DOCUMENT. ALSO, LET US
  162. KNOW WHERE YOU OBTAINED YOUR COPY OF CAPITAL GAINZ.
  163.  
  164.  
  165. Installation
  166. ------------
  167.     To install Capital Gainz, simply insert the PROGRAM disk (or
  168.  
  169.                                                                      3
  170.  
  171.  
  172.  
  173.  
  174.  
  175. whichever disk contains INSTALL.EXE) into one of your PC's floppy
  176. diskette drives and (if you inserted the disk into drive A) type:
  177.  
  178.     A:INSTALL
  179.  
  180. You will be prompted for the necessary information, and any
  181. directories requested will be created if they do not exist. If you are
  182. installing a registered version, you will also be prompted for the
  183. Registration Number on the distribution diskette. If there is a
  184. separate UPGRADE or DOC disk, you'll be prompted to insert it as
  185. needed. After installation, the new Capital Gainz directory will be
  186. your current working directory. Detailed information on the
  187. installation process is included in the User's Manual (CAPGNZ.DOC).
  188.  
  189.     Common installation problems include: bad diskettes, corrupt data
  190. caused by electronic transmission errors, and incorrect composition of
  191. the archives on the diskettes. The result of these kinds of problems
  192. are installation errors indicating: invalid archive, invalid archive
  193. format, or disk read errors. If you run into a similar problem,
  194. contact your original source for a replacement. If you encounter
  195. problems getting a replacement, contact us directly and let us know
  196. where you obtained your copy. 
  197.  
  198. CONFIG.SYS File
  199. ---------------
  200.     The maximum number of open files allowed, as indicated by the
  201. 'FILES=nn' statement in the CONFIG.SYS file in your root directory,
  202. may need to be increased in order to run Capital Gainz. You can have
  203. Capital Gainz do this automatically on installation, or else do it
  204. manually with a text editor. Given normal configurations, a setting of
  205. FILES=30 should be sufficient. However, you may need to bump it up to
  206. 40. You must reboot your system for this new setting to be in effect.
  207.  
  208. Documentation
  209. -------------
  210.     After installation is complete, these three important Capital
  211. Gainz documents will be on your disk:
  212.  
  213.      README.DOC - this file.
  214.  
  215.      LICENSE.DOC - information on ordering the registered and
  216.      professional versions of Capital Gainz, and the Capital Gainz
  217.      license agreement.
  218.  
  219.      CAPGNZ.DOC - Capital Gainz user's manual (over 200 pages). In the
  220.      online version of the manual, screen shots, example reports, and
  221.      several chapters are omitted.
  222.  
  223.      TOUR.DOC - the Quick Tour chapter from CAPGNZ.DOC, only in the
  224.  
  225.                                                                      4
  226.  
  227.  
  228.  
  229.  
  230.  
  231.      shareware version.
  232.  
  233.     You can view or print these files from within Capital Gainz using
  234. the View Documentation option from the Main Menu. While viewing the
  235. users manual, use the Goto Page feature to quickly jump to page
  236. numbers listed in the Table of Contents. If you have a registered
  237. version of Capital Gainz and a laser printer, you can also use the
  238. DP.EXE utility to print two pages per sheet of paper, in landscape
  239. mode. Try it with a small file, such as this README.DOC file, before
  240. printing a large document:
  241.  
  242.     DP README.DOC
  243.  
  244. For a list of options, type:
  245.  
  246.     DP ?
  247.  
  248. Getting Started
  249. ---------------
  250.     If you don't want to read (or print) the entire Capital Gainz
  251. User's Manual before getting started, you may want to at least read
  252. over the Quick Tour chapter to get you up and running as quickly as
  253. possible. Also be sure to refer to the LICENSE.DOC file for usage and
  254. distribution guidelines, as well as restrictions that apply if this is
  255. an unregistered shareware version of Capital Gainz. To start up
  256. Capital Gainz, type:
  257.  
  258.     CG
  259.  
  260. in the directory you specified during installation.
  261.  
  262.     Capital Gainz data files (*.DAT and *.K01) and help files (*.HLP)
  263. must be located in the directory that you're in when you start Capital
  264. Gainz. The DOS search path can be used to locate the Capital Gainz
  265. executable file. 
  266.  
  267. Backing Up Data
  268. ---------------
  269.     I strongly urge you to regularly backup your Capital Gainz data
  270. files. There is a Backup option on the Main Menu that executes the
  271. backup command entered in the User Settings Form, but since data files
  272. must be closed and data swapped to disk before calling DOS, this
  273. option may prove too slow on older 8086 PCs. If this is the case, use
  274. your favorite backup or compression utility to backup the data files
  275. before or after running Capital Gainz. You can even modify the CG.BAT
  276. startup file to do this automatically. Alternatively, you can use the
  277. DOS COPY command in a batch file to copy the data files to a backup
  278. diskette.
  279.  
  280.  
  281.                                                                      5
  282.  
  283.  
  284.  
  285.  
  286.  
  287.     The data files that should be backed up are identified by the
  288. following DOS file templates:
  289.  
  290.     *.DAT
  291.     *.K01
  292.  
  293. Included in this release is an example batch file, CAPGNZBU.BAT, that
  294. backs up Capital Gainz data files using the DOS COPY command.
  295. CAPGNZBU.BAT accepts the letter of the drive to copy the data files to
  296. as its only argument. Thus, to backup data from the current directory
  297. to the diskette in drive A:
  298.  
  299.     CAPGNZBU A
  300.  
  301. Problems with Category Methods
  302. ------------------------------
  303.     Prior to version 3.0, Capital Gainz had some shortcomings in its
  304. handling of the category selling methods. As correctly described in
  305. the manual, the average price, not the actual purchase price, was
  306. subtracted from the total purchase amount when changing/deleting open
  307. share records. Version 3.0 includes robust implementations of the
  308. category methods, subtracting the actual purchase price on
  309. changes/deletions and tracing through the chronological history of the
  310. shares when you choose the Total option on the Fixup Form. This is
  311. possible since both the actual and the average price are now stored in
  312. the sold shares records. For the double category method, share
  313. 'migration' is now user controlled instead of being automatically
  314. based on the system date.
  315.  
  316.     If you have any securities that use a category method, be sure to
  317. check them. If you have not sold any shares, then the easiest
  318. verification process is to run Fixup from the Local Security Table,
  319. choosing the Total option on the Fixup Form. If you have sold shares,
  320. then you can do one of: manually enter the correct values on the Fixup
  321. Form if they are incorrect; delete (don't unsell) the sold shares
  322. records, manually reenter them, and run Fixup/Total before re-
  323. executing the sale; delete/unsell the sold shares records, manually
  324. change the purchase prices, and run Fixup/Total before re-executing
  325. the sale; export the sold shares records, delete (don't unsell) the
  326. sold shares records, edit the exported records to set the actual
  327. purchase price, import only the sold shares records that you deleted
  328. earlier, and run Fixup/Total.
  329.  
  330.     I apologize for any problems this may have caused, and would be
  331. glad to provide additional help as needed.
  332.  
  333.  
  334. Problems With Selling Shares
  335. ----------------------------
  336.  
  337.                                                                      6
  338.  
  339.  
  340.  
  341.  
  342.  
  343.     Prior to version 3.0h (04/06/92), Capital Gainz examined all
  344. purchases when you executed a sale, not just those prior to the
  345. entered selling date. Thus, if you used the Maximum Loss selling
  346. method to record a sale on 6/1/91, but had entered purchases up
  347. through 12/1/91, then all of the purchases would have been examined.
  348. Also, if you used a category method, all purchases would be factored
  349. into the average price for the sale, not just those purchases prior to
  350. the sale.  Unfortunately, we had assumed users would record sales
  351. prior to subsequent purchases. If you did not record purchases until
  352. all prior sales had been recorded, or used the LIFO or ID methods,
  353. there was no problem. Version 3.0h now restricts open shares by the
  354. sale date, and even recalculates the average price as of the sale
  355. date.
  356.  
  357. Double Category Will No Longer Be Supported
  358. -------------------------------------------
  359.     Possibly in the next release, support for the DCAT (double
  360. category) selling method will be discontinued. The effort and overhead
  361. of maintaining this method simply can't be justified by its
  362. questionable benefit. Please let us know if this presents a problem -
  363. currently, only one user is known to use this method. Of course, the
  364. single category average method will continue to be supported
  365. indefinitely.
  366.  
  367. Upgrading to Version 3.0
  368. ------------------------
  369.     If you were not maintaining multiple portfolios using DOS
  370. subdirectories, you can skip this section. A single default portfolio
  371. will be created for your data during the upgrade process. However, if
  372. you are upgrading and have been maintaining multiple portfolios using
  373. DOS subdirectories, you'll need to use the Capital Gainz Utility
  374. Program to merge the portfolios.
  375.  
  376.     Using DOS subdirectories for different portfolios required
  377. considerable data duplication. Version 3.0's support for multiple
  378. portfolios consolidates this duplicate data. On installation, you can
  379. enter the subdirectories containing data that must be upgraded. You
  380. can also upgrade these directories after installation. When you
  381. upgrade your Capital Gainz data files, a default portfolio is created
  382. in each subdirectory. After installation, you can skim over the
  383. Capital Gainz Users Manual for information on how the data files are
  384. set up for multiple portfolios. In particular, read the discussions on
  385. the Portfolio File, the Global Security File, and the Local Security
  386. File. Then, follow these steps to merge your portfolios:
  387.  
  388. o    If you did not upgrade all of the subdirectories at installation,
  389.      upgrade them now using the Upgrade option in the Capital Gainz
  390.      Utility Program, CGUTIL.EXE. The Utility Program is described in
  391.      detail in the Capital Gainz Users Manual. By upgrading, each
  392.  
  393.                                                                      7
  394.  
  395.  
  396.  
  397.  
  398.  
  399.      directory will contain a single version 3.0 portfolio. You can
  400.      change directories from within the Utility Program. 
  401.  
  402. o    Make certain that you don't have any conflicting security symbols
  403.      in various directories. In other words, if you used the same
  404.      security symbol to represent completely different securities, run
  405.      Capital Gainz in the directories to rename the conflicting
  406.      securities. If a given symbol represented the same security for
  407.      multiple portfolios, there's no problem - the security
  408.      definitions will be merged while individual values are maintained
  409.      in separate portfolios. For instance, if you used FPINC to
  410.      represent the Financial Progress Daily Income mutual fund in one
  411.      directory, and used FPINC to represent the Financial Progress
  412.      Industrial Income Fund in another directory, rename one or both
  413.      of them using the Global Security Form in Capital Gainz. If you
  414.      used FPINC to represent Financial Progress Daily Income in both
  415.      directories, you don't have to change anything. Each holding of
  416.      FPINC will be in a different portfolio.
  417.  
  418. o    Also, make certain that you don't have any conflicting
  419.      broker/investment company names in various directories. If the
  420.      same name represented different broker/investment companies, then
  421.      run Capital Gainz in the directories to rename the conflicting
  422.      broker/investment companies with the Broker/Investment Company
  423.      Form. For instance, if you used Fidelity for the Fidelity Mutual
  424.      Funds in one directory and Fidelity for the Fidelity Brokerage in
  425.      another directory, rename one or both of them. If you used
  426.      Fidelity to represent the Fidelity Mutual Funds in both
  427.      directories, you don't have to change anything. The two
  428.      broker/investment companies will be merged into one.
  429.  
  430. o    Copy the portfolios from the other directories to the
  431.      installation directory using the Copy/Move Portfolios option in
  432.      the Utility Program. This will eliminate duplicate security
  433.      definitions and broker/investment companies while separating the
  434.      holdings from each directory into individual portfolios. When you
  435.      copy a portfolio with the Utility Program, a new portfolio ID is
  436.      generated for it in the destination directory.
  437.  
  438. o    When you are finished, run Capital Gainz in the installation
  439.      directory, where you copied all of your portfolios to. Make sure
  440.      the data is correct. Then, you can exit from Capital Gainz and
  441.      delete the files in the old subdirectories.
  442.  
  443. Acknowledgements
  444. ----------------
  445.     INSTALL.EXE uses the SPAWNO routines by Ralf Brown to minimize
  446. memory use when running other programs.
  447.  
  448.  
  449.                                                                      8
  450.