home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / capgnz32.zip / README.DOC < prev    next >
Text File  |  1994-07-01  |  16KB  |  388 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                        Capital Gainz Version 3.2
  8.       Copyright 1991-93 by David Lee Cohen. All Rights Reserved.
  9.  
  10.                               Dave Cohen
  11.                         AlleyCat Software, Inc.
  12.                             P.O. Box 14446
  13.                           RTP, NC  27709-4446
  14.                             (919)-542-6117
  15.                         (919)-542-6611 BBS/FAX
  16.                        CompuServe ID: 70431,132
  17.                             Prodigy:WFCX17A
  18.                  Internet:davec@mercury.interpath.net
  19.  
  20.                              July 1, 1994
  21.  
  22.                        _______ 
  23.                  ____|__     |               (R) 
  24.               --|       |    |------------------- 
  25.                 |   ____|__  |  Association of 
  26.                 |  |       |_|  Shareware 
  27.                 |__|   o   |    Professionals 
  28.               -----|   |   |--------------------- 
  29.                    |___|___|    MEMBER 
  30.  
  31.  
  32. ======================================================================
  33. Capital Gainz, the Capital Gainz Utility Program, the Capital Gainz
  34. Graphics Program, the Capital Gainz Download Program, the Capital
  35. Gainz Demo, and all online and printed Capital Gainz documentation are
  36. Copyright 1993 by David Lee Cohen. Unauthorized duplication or
  37. distribution is prohibited.
  38. ======================================================================
  39.  
  40. READ THIS ENTIRE DOCUMENT: It contains important information!
  41.  
  42. This is an unregistered evaluation version of Capital Gainz if it was
  43. obtained from a shareware disk vendor, an electronic bulletin board,
  44. or a source other than AlleyCat Software, Inc. and David Lee Cohen; or
  45. during program sign-on the phrase "shareware" or "evaluation" is
  46. displayed. Otherwise, this is a registered version of Capital Gainz,
  47. purchased by and registered to you. If this is an evaluation version
  48. of Capital Gainz, after installation refer to the document LICENSE.DOC
  49. for details on the evaluation version's restrictions and for
  50. information on ordering a registered version of Capital Gainz. Also
  51. included in LICENSE.DOC is a list of what you get with registration.
  52. Please note that we receive no part of any fee charged by disk vendors
  53. or sysops for the evaluation version. 
  54.  
  55. Requirements:
  56. -------------
  57.     Capital Gainz requires:
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      - An IBM compatible PC, 386sx processor or better recommended
  64.      - DOS 3.00 or later
  65.      - Any monochrome or CGA/EGA/VGA monitor
  66.      - A minimum of 640KB of RAM, with 520KB free
  67.      - A hard disk, with between 2MB and 5MB of free space
  68.      - A printer is NOT required
  69.      - For the Graphics Program, Hercules/EGA/VGA graphics required
  70.      - For the Download Program, a modem is required
  71.  
  72.      - Approximate disk space requirements:
  73.           - Capital Gainz program and libraries: 1.2MB
  74.           - Several years of user data: 200KB
  75.           - Online documentation (optional): 500KB
  76.           - Demo/tutorial (optional): 700KB
  77.           - Utility Program: 500KB
  78.           - Graphics Program: 600KB
  79.           - Download Program: 600KB
  80.  
  81. Distribution, Registration:
  82. ---------------------------
  83. Distribution restrictions are detailed in the VENDOR.DOC file.
  84. Registration requirements are discussed in LICENSE.DOC. This software
  85. is not public domain, and failure to abide by the distribution
  86. restrictions constitutes a violation of the U.S. and International
  87. Copyright laws.
  88.  
  89. Upgrading to a New Revision or
  90. Converting to a Registered Version
  91. -----------------------------------
  92. If you already have a version of Capital Gainz installed, install the
  93. new version in the same directory. Only program and documentation
  94. files will be overwritten. Existing data files may be upgraded, but
  95. will otherwise not be affected. 
  96.  
  97. Sometimes, a change in file formats requires an upgrade of existing
  98. data files. If this is the case, the upgrade function of the Capital
  99. Gainz Utility Program will be invoked automatically during
  100. installation. IF YOU ARE UPGRADING, YOU SHOULD INSTALL THE NEW VERSION
  101. IN THE DIRECTORY CONTAINING THE OLD PROGRAM FILES. When attempting to
  102. run a new version of Capital Gainz against old data files that were
  103. not upgraded, you may receive the error "Invalid Record Declaration"
  104. when running Capital Gainz. If you experience this problem, run the
  105. Capital Gainz Utility Program to upgrade your data files.
  106.  
  107. YOU CAN ONLY INSTALL A NEW REGISTERED VERSION OVER AN OLD EVALUATION
  108. OR REGISTERED VERSION. DO NOT INSTALL A NEW EVALUATION VERSION OVER AN
  109. OLD EXISTING VERSION.
  110.  
  111. The HISTORY.DOC file contains a list of major changes between
  112. revisions of Capital Gainz.
  113.  
  114.  
  115.  
  116.  
  117.  
  118. Prepare for Installation
  119. ------------------------
  120. You should have one or more diskettes containing the following:
  121.  
  122.   For Capital Gainz:
  123.      - INSTALL.EXE, INSTALL.INF, INSTALL.HLP, WINSTALL.EXE, README.DOC
  124.      - CGZCD32.EXE - Documentation archive
  125.      - CGZCL32.EXE - Runtime library archive
  126.      - CGZCP32.EXE - Capital Gainz Program archive
  127.      - CGZCT32.EXE - Demo/tutorial archive
  128.      - CGZCX32.EXE - Example data archive
  129.   For the Utility Program:
  130.      - CGZUD32.EXE - Utility Program document archive
  131.      - CGZUP32.EXE - Utility Program archive
  132.   For the Graphics Program:
  133.      - CGZGD32.EXE - Graphics Program document archive
  134.      - CGZGP32.EXE - Graphics Program archive
  135.   For the Download Program:
  136.      - CGZDD32.EXE - Download Program document archive
  137.      - CGZDP32.EXE - Download Program archive
  138.      - CGZDS32.EXE - Download Program script archive
  139.  
  140. For BBS distribution, the archives are combined into a ZIP file which
  141. must be decompressed to a diskette or directory on your hard drive
  142. prior to installation.
  143.  
  144. Installation
  145. ------------
  146. To install Capital Gainz, execute INSTALL.EXE. For instance, if you
  147. inserted the Install disk into drive A, type:
  148.  
  149.      C:>A:INSTALL
  150.  
  151. You will be prompted for the necessary information, and any
  152. directories requested will be created if they do not exist. Online
  153. help is available by hitting the F1 key. You'll be prompted to insert
  154. disks as needed. After installation, the new Capital Gainz directory
  155. will be your current working directory. Detailed information on the
  156. installation process is included in the User's Manual.
  157.  
  158. Common installation problems include: bad diskettes, corrupt data
  159. caused by electronic transmission errors, and incorrect composition of
  160. the archives on the diskettes. The result of these kinds of problems
  161. are installation errors indicating: invalid archive, invalid archive
  162. format, or disk read errors. If you run into a similar problem,
  163. contact your original source for a replacement. If you encounter
  164. problems getting a replacement, contact us directly and let us know
  165. where you obtained your copy.
  166.  
  167.  
  168. "Can't Execute CGINST.BAT"
  169.  
  170.  
  171.  
  172.  
  173.  
  174. --------------------------
  175. This is a common error caused by trying to install Capital Gainz on a
  176. computer that was booted from a floppy disk. The installation program
  177. creates a batch file to unarchive the Capital Gainz files, then
  178. 'shells' to DOS to execute it. If the command processor (COMMAND.COM)
  179. was on a floppy disk that was swapped out, then the process will fail.
  180. You should try to install and run Capital Gainz on a computer with DOS
  181. installed on the hard disk. If you can't, you can exit from the
  182. installation program after seeing this error, and run the batch file
  183. manually:
  184.  
  185.     C:>CD \CAPGNZ
  186.     C:>CGINST
  187.  
  188. Documentation
  189. -------------
  190. After installation is complete, these important Capital Gainz
  191. documents will be on your disk:
  192.  
  193.      LICENSE.DOC - the license agreement and information on ordering
  194.      the registered version of Capital Gainz.
  195.  
  196.      CGnn.DOC - Chapter 'nn' of the Capital Gainz user's manual, used
  197.      for online, context-sensitive help.
  198.  
  199. You can view or print the documentation from within Capital Gainz
  200. using the View Documentation option from the Main Menu. 
  201.  
  202. Getting Started
  203. ---------------
  204. Before entering your own data, I strongly recommend that you run the
  205. Demo/Tutorial screen show. To run it, you must be in the
  206. drive/directory where the screen libraries (CGSCR*.LBR) are located.
  207. For example, if the demo is in \CAPGNZ\DEMO on drive C:
  208.  
  209.   C:>CD \CAPGNZ\DEMO
  210.   C:>CGDEMO
  211.  
  212. The demo works best on EGA/VGA color monitors. For others, highlighted
  213. fields may not show up.
  214.  
  215. The demo/tutorial files consume considerable disk space. To remove
  216. them when you're done:
  217.  
  218.   C:> CD \CAPGNZ
  219.   C:> DEL DEMO\*.*
  220.   C:> RMDIR DEMO
  221.  
  222. In the Graphics Program part of the demo, several PCX graphics files
  223. can be displayed. However, the graphics images included with the demo
  224. will only work on VGA monitors.
  225.  
  226.  
  227.  
  228.  
  229.  
  230. Running Capital Gainz
  231. ---------------------
  232. Be sure to refer to the LICENSE.DOC file for usage and distribution
  233. guidelines. To start up Capital Gainz:
  234.  
  235.     C:>CD \CAPGNZ
  236.     C:>CG
  237.  
  238. Backing Up Data
  239. ---------------
  240. You really should regularly backup your Capital Gainz data files, as
  241. data is easily corrupted by disk errors or misbehaved applications.
  242. There is even a Backup option on the Main Menu to make this process
  243. easy. The data files are backed up are: *.DAT and *.K01.
  244.  
  245. Enhancements
  246. ------------
  247. Capital Gainz is constantly being enhanced. My goal is to put out a
  248. release every 6-9 months, with every other one being a 'major' release
  249. with significant new features. Registered users are notified of
  250. updates, and can receive the upgrade for a small fee. I don't want
  251. anyone getting the impression that these frequent updates are meant to
  252. just increase revenues. Rather, I feel an obligation to offer the best
  253. product possible to those who have supported me in the past. 
  254.  
  255. If You Like It
  256. --------------
  257. If you like Capital Gainz, let me know. Also, pass along any
  258. suggestions - many features added over the years originated from user
  259. feedback. If friends or co-workers are interested, tell them to
  260. contact me and I'll send them a free evaluation copy of Capital Gainz.
  261. Of course, any mention of Capital Gainz in correspondence to magazines
  262. or newspapers is greatly encouraged and appreciated. Finally, if
  263. you're interested, I'm always looking for volunteers to try out new
  264. features in pre-releases of Capital Gainz.
  265.  
  266. Documentation Changes
  267. ---------------------
  268.      A 'Change Source' function is shown in some Download and Graphics
  269.      Program documentation. This feature was dropped at the last
  270.      minute.
  271.  
  272.      Return of principal distributions were changed to allow 'uneven'
  273.      amounts applied to different open records. This removes the
  274.      restriction that all open records must have at least the per
  275.      share amount recorded. Also, if the total return of principal
  276.      recorded exceeds the available basis, short and/or long term
  277.      capital gains distributions are recorded for the excess. Also,
  278.      deleting return of principal distributions no longer supports
  279.      open amount adjustments, because of the potential for uneven per
  280.      share amounts across different records.
  281.  
  282.  
  283.  
  284.  
  285.  
  286.      In the Compuserve download script, \CAPGNZ\DNLD\CGCOMP.SCR, some
  287.      users hang up at the initial menu, and you may need to add this
  288.      line before ::ELOGON:
  289.           <<!
  290.  
  291.      Telechart 2000 data can be restricted by date and security. If
  292.      CURRENT prices are chosen, only the prices for the specified date
  293.      are read in. Otherwise, the FROM DATE and TO DATE restrict the
  294.      price data.
  295.  
  296.      In the Download Program, you are assumed to use full, 80
  297.      character length lines when communicating with services. If, for
  298.      instance, you have your terminal characteristics set up for 40
  299.      character lines with Compuserve, downloaded BasicQuotes are
  300.      generated in a format that the Download Program's conversion
  301.      utility will not understand. To change terminal characteristics,
  302.      use the communication service's setup facility - in Compuserve,
  303.      you can get there with GO PROFILE.
  304.  
  305.      Although stock quote downloads are supported, you should avoid
  306.      accumulating large amounts of price data. Capital Gainz is an
  307.      investment management tool, not a technical analysis tool, and is
  308.      not optimized to handle large amounts of price data quickly. I
  309.      suggest weekly price updates at the most. If you must pull in
  310.      daily data, at least use the Utility Program's Rebuild Price
  311.      History to occasionally weed out prices to a weekly or monthly
  312.      frequency.
  313.  
  314.      The Download Program supports non-standard IRQ and port addresses
  315.      through the \CAPGNZ\DNLD\CGDNLD.IRQ file. You can create this
  316.      text file with any editor. Add one or more comma-delimited
  317.      records in this format:
  318.           PORT,IRQ,ADDRESS
  319.      So, if you use COM2 (standard IRQ 3, address 2F8), but it uses
  320.      the IRQ and address normally used for COM1 (IRQ 4, address 3F8):
  321.           2,4,1016
  322.  
  323.      Note that the address must be decimal, not hexadecimal.
  324.  
  325.      The Download Program defaults to touchtone dialing, using the 'AT
  326.      DT' modem command. You can switch to pulse dialing by creating
  327.      the file \CAPGNZ\DNLD\CGDNLD.MDM, and defining the dialing
  328.      command:
  329.           D=AT DP
  330.  
  331.      For Prodigy, you can now set the Download Program to create and
  332.      download Quote Tracks, or to just download existing Quote Tracks.
  333.      If you have a lot of symbols that you regularly retrieve quotes
  334.      for, use CGPRODC.SCR to create Quote Tracks for the first time,
  335.      or to recreate them after adding/changing/deleting symbols in the
  336.      Download Program. Then, use CGPRODX.SCR to use existing Quote
  337.  
  338.  
  339.  
  340.  
  341.  
  342.      Tracks, skipping the Prodigy commands to create new ones.
  343.  
  344.      When requesting Historical quotes in Compuserve, always retrieve
  345.      quotes for more than a single day. When just one day's quotes are
  346.      requested in MQDATA and read into a DIF file, the format is
  347.      completely different than in all other cases, and the Download
  348.      Program does not recognize it. This is just a Compuserve anomaly.
  349.  
  350.      Capital Gainz can not automate price retrieval from
  351.      Prodigy/Windows. To get prices, manually retrieve prices into
  352.      COMMA-DELIMITED file. Then, use the Download Program's
  353.      Convert/Input option to read the file(s) in.
  354.  
  355.      Prodigy does not care a bit about 3rd party products such as the
  356.      Download program. They change the service whenever the urge hits.
  357.      This has broken the Download Program's scripts 6 times from 9/93
  358.      to 1/94. If you use automated downloads from Prodigy, get used to
  359.      retrieving updated scripts from our BBS. Also, you are encouraged
  360.      to send nasty email to Prodigy support about this.
  361.  
  362.      The Download Program can now Convert/Input downloaded COMMA-
  363.      DELIMITED Prodigy files in either CLOSING or CURRENT price
  364.      format.
  365.  
  366.      The Download Program can now Convert/Input price files from
  367.      America Online. If you are installing the Download Program for
  368.      the first time, then the AOL service will be defined in the
  369.      Services file. Otherwise, you'll need to add the AOL service in
  370.      the Download Program: 
  371.  
  372.           Accept all the default file names that will be displayed
  373.           after you enter AOL as the service - these should be
  374.           CGAOL.TIC for Ticker Symbol File, CGAOL.DNL for Download
  375.           Data File, CGAOL.INP for Final Input Data File, and
  376.           CGAOL.PAR for Parameter File. The Download Script File is
  377.           not used.
  378.  
  379.           For the Conversion Program, specify CGCV.EXE, which has been
  380.           updated to support AOL conversion. 
  381.  
  382.      Note that the Download Program does not automate access of
  383.      America Online - it simply allows you to convert and read in
  384.      files created from their portfolio management features. Thus, use
  385.      option 3 on the Download Program's Main Menu, and specify CURRENT
  386.      prices. The downloaded data does not include dates, so the Price
  387.      Date on the Main Menu is used.
  388.