home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR15 / CGZCP32L.ZIP / README.DOC < prev    next >
Text File  |  1993-11-21  |  14KB  |  354 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)-469-5196
  15.                           (919)-469-3972 BBS
  16.                        CompuServe ID: 70431,132
  17.                             Prodigy:WFCX17A
  18.                     Internet:davec@rock.concert.net
  19.  
  20.                            November 21, 1993
  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
  43. was obtained from a shareware disk vendor, an electronic bulletin
  44. board, or a source other than AlleyCat Software, Inc. and David Lee
  45. Cohen; or during program sign-on the phrase "shareware" or
  46. "evaluation" is displayed. Otherwise, this is a registered version of
  47. Capital Gainz, purchased by and registered to you. If this is an
  48. evaluation version of Capital Gainz, after installation refer to the
  49. document LICENSE.DOC for details on the evaluation version's
  50. restrictions and for information on ordering a registered version of
  51. Capital Gainz. Also included in LICENSE.DOC is a list of what you get
  52. with registration. Please note that we receive no part of any fee
  53. charged by disk vendors 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
  93. the 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
  98. existing data files. If this is the case, the upgrade function of the
  99. Capital 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
  108. EVALUATION OR REGISTERED VERSION. DO NOT INSTALL A NEW EVALUATION
  109. VERSION OVER AN 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.      - CGZCDnn.xxx - Documentation archive
  125.      - CGZCLnn.xxx - Runtime library archive
  126.      - CGZCPnn.xxx - Capital Gainz Program archive
  127.      - CGZCTnn.xxx - Demo/tutorial archive
  128.      - CGZCXnn.xxx - Example data archive
  129.   For the Utility Program:
  130.      - CGZUDnn.xxx - Utility Program document archive
  131.      - CGZUPnn.xxx - Utility Program archive
  132.   For the Graphics Program:
  133.      - CGZGDnn.xxx - Graphics Program document archive
  134.      - CGZGPnn.xxx - Graphics Program archive
  135.   For the Download Program:
  136.      - CGZDDnn.xxx - Download Program document archive
  137.      - CGZDPnn.xxx - Download Program archive
  138.      - CGZDSnn.xxx - Download Program script archive
  139.  
  140.   'nn' refers to the version/subversion number, such as 32.
  141.   'xxx' refers to the archive extension, such as ZIP or EXE.
  142.  
  143. For BBS distribution, the archives are different:
  144.      - CGZCDnn.xxx - Capital Gainz document and tutorial (required)
  145.      - CGZCPnn.xxx - Capital Gainz Program and library (required)
  146.  
  147. Installation
  148. ------------
  149.     To install Capital Gainz, execute INSTALL.EXE. For instance, if
  150. you inserted the Install disk into drive A, type:
  151.  
  152.      C:>A:INSTALL
  153.  
  154. You will be prompted for the necessary information, and any
  155. directories requested will be created if they do not exist. Online
  156. help is available by hitting the F1 key. You'll be prompted to insert
  157. disks as needed. After installation, the new Capital Gainz directory
  158. will be your current working directory. Detailed information on the
  159. installation process is included in the User's Manual.
  160.  
  161.     Common installation problems include: bad diskettes, corrupt data
  162. caused by electronic transmission errors, and incorrect composition of
  163. the archives on the diskettes. The result of these kinds of problems
  164. are installation errors indicating: invalid archive, invalid archive
  165. format, or disk read errors. If you run into a similar problem,
  166. contact your original source for a replacement. If you encounter
  167. problems getting a replacement, contact us directly and let us know
  168. where you obtained your copy.
  169.  
  170.  
  171.  
  172.  
  173.  
  174.     INSTALL is not included in the BBS distributions. You should
  175. create the target directories and unarchive the files to them.
  176. Assuming you have the files in \PROCOMM\DL:
  177.  
  178.      C:>MKDIR \CAPGNZ
  179.      C:>MKDIR \CAPGNZ\DOC
  180.      C:>CD \CAPGNZ
  181.      C:>PKUNZIP \PROCOMM\DL\CGZCP32.ZIP
  182.      C:>CD DOC
  183.      C:>PKUNZIP \PROCOMM\DL\CGZCD32.ZIP
  184.  
  185. Since there is no INSTALL program, you'll need to run CAPGNZ.EXE the
  186. first time to create the CG.BAT startup file and the CAPGNZ.INF
  187. information file. From then on, you can use CG.BAT to run the program.
  188.  
  189. "Can't Execute CGINST.BAT"
  190. --------------------------
  191.     This is a common error caused by trying to install Capital Gainz
  192. on a computer that was booted from a floppy disk. The installation
  193. program creates a batch file to unarchive the Capital Gainz files,
  194. then 'shells' to DOS to execute it. If the command processor
  195. (COMMAND.COM) was on a floppy disk that was swapped out, then the
  196. process will fail. You should try to install and run Capital Gainz on
  197. a computer with DOS installed on the hard disk. If you can't, you can
  198. exit from the installation program after seeing this error, and run
  199. the batch file manually:
  200.  
  201.     C:>CD \CAPGNZ
  202.     C:>CGINST
  203.  
  204. Documentation
  205. -------------
  206.     After installation is complete, these important Capital Gainz
  207. documents will be on your disk:
  208.  
  209.      LICENSE.DOC - the license agreement and information on ordering
  210.      the registered version of Capital Gainz.
  211.  
  212.      CGnn.DOC - Chapter 'nn' of the Capital Gainz user's manual, used
  213.      for online, context-sensitive help.
  214.  
  215.     You can view or print the documentation from within Capital Gainz
  216. using the View Documentation option from the Main Menu. 
  217.  
  218. Getting Started
  219. ---------------
  220.     Before entering your own data, I strongly recommend that you run
  221. the Demo/Tutorial screen show. To run it, you must be in the
  222. drive/directory where the screen libraries (CGSCR*.LBR) are located.
  223. For example, if the demo is in \CAPGNZ\DEMO on drive C:
  224.  
  225.  
  226.  
  227.  
  228.  
  229.   C:>CD \CAPGNZ\DEMO
  230.   C:>CGDEMO
  231.  
  232. The demo works best on EGA/VGA color monitors. For others, highlighted
  233. fields may not show up.
  234.  
  235.     The demo/tutorial files consume considerable disk space. To remove
  236. them when you're done:
  237.  
  238.   C:> CD \CAPGNZ
  239.   C:> DEL DEMO\*.*
  240.   C:> RMDIR DEMO
  241.  
  242. In the Graphics Program part of the demo, several PCX graphics files
  243. can be displayed. However, the graphics images included with the demo
  244. will only work on VGA monitors.
  245.  
  246. Running Capital Gainz
  247. ---------------------
  248.     Be sure to refer to the LICENSE.DOC file for usage and
  249. distribution guidelines. To start up Capital Gainz:
  250.  
  251.     C:>CD \CAPGNZ
  252.     C:>CG
  253.  
  254. Backing Up Data
  255. ---------------
  256.     You really should regularly backup your Capital Gainz data files,
  257. as data is easily corrupted by disk errors or misbehaved applications.
  258. There is even a Backup option on the Main Menu to make this process
  259. easy. The data files are backed up are: *.DAT and *.K01.
  260.  
  261. Enhancements
  262. ------------
  263.     Capital Gainz is constantly being enhanced. My goal is to put out
  264. a release every 6-9 months, with every other one being a 'major'
  265. release with significant new features. Registered users are notified
  266. of updates, and can receive the upgrade for a small fee. I don't want
  267. anyone getting the impression that these frequent updates are meant to
  268. just increase revenues. Rather, I feel an obligation to offer the best
  269. product possible to those who have supported me in the past. 
  270.  
  271. If You Like It
  272. --------------
  273.     If you like Capital Gainz, let me know. Also, pass along any
  274. suggestions - many features added over the years originated from user
  275. feedback. If friends or co-workers are interested, tell them to
  276. contact me and I'll send them a free evaluation copy of Capital Gainz.
  277. Of course, any mention of Capital Gainz in correspondence to magazines
  278. or newspapers is greatly encouraged and appreciated. Finally, if
  279. you're interested, I'm always looking for volunteers to try out new
  280.  
  281.  
  282.  
  283.  
  284.  
  285. features in pre-releases of Capital Gainz.
  286.  
  287. Documentation Changes
  288. ---------------------
  289.      A 'Change Source' function is shown in some Download and Graphics
  290.      Program documentation. This feature was dropped at the last
  291.      minute.
  292.  
  293.      Return of principal distributions were changed to allow 'uneven'
  294.      amounts applied to different open records. This removes the
  295.      restriction that all open records must have at least the per
  296.      share amount recorded. Also, if the total return of principal
  297.      recorded exceeds the available basis, short and/or long term
  298.      capital gains distributions are recorded for the excess. Also,
  299.      deleting return of principal distributions no longer supports
  300.      open amount adjustments, because of the potential for uneven per
  301.      share amounts across different records.
  302.  
  303.      Telechart 2000 data can be restricted by date and security. If
  304.      CURRENT prices are chosen, only the prices for the specified date
  305.      are read in. Otherwise, the FROM DATE and TO DATE restrict the
  306.      price data.
  307.  
  308.      In the Download Program, you are assumed to use full, 80
  309.      character length lines when communicating with services. If, for
  310.      instance, you have your terminal characteristics set up for 40
  311.      character lines with Compuserve, downloaded BasicQuotes are
  312.      generated in a format that the Download Program's conversion
  313.      utility will not understand. To change terminal characteristics,
  314.      use the communication service's setup facility - in Compuserve,
  315.      you can get there with GO PROFILE.
  316.  
  317.      Although stock quote downloads are supported, you should avoid
  318.      accumulating large amounts of price data. Capital Gainz is an
  319.      investment management tool, not a technical analysis tool, and is
  320.      not optimized to handle large amounts of price data quickly. I
  321.      suggest weekly price updates at the most. If you must pull in
  322.      daily data, at least use the Utility Program's Rebuild Price
  323.      History to occasionally weed out prices to a weekly or monthly
  324.      frequency.
  325.  
  326.      The Download Program supports non-standard IRQ and port addresses
  327.      through the \CAPGNZ\DNLD\CGDNLD.IRQ file. You can create this
  328.      text file with any editor. Add one or more comma-delimited
  329.      records in this format:
  330.           PORT,IRQ,ADDRESS
  331.      So, if you use COM2 (standard IRQ 3, address 2F8), but it uses
  332.      the IRQ and address normally used for COM1 (IRQ 4, address 3F8):
  333.           2,4,1016
  334.  
  335.      Note that the address must be decimal, not hexadecimal.
  336.  
  337.  
  338.  
  339.  
  340.  
  341.      The Download Program defaults to touchtone dialing, using the 'AT
  342.      DT' modem command. You can switch to pulse dialing by creating
  343.      the file \CAPGNZ\DNLD\CGDNLD.MDM, and defining the dialing
  344.      command:
  345.           D=AT DP
  346.  
  347.      For Prodigy, you can now set the Download Program to create and
  348.      download Quote Tracks, or to just download existing Quote Tracks.
  349.      If you have a lot of symbols that you regularly retrieve quotes
  350.      for, use CGPRODC.SCR to create Quote Tracks for the first time,
  351.      or to recreate them after adding/changing/deleting symbols in the
  352.      Download Program. Then, use CGPRODX.SCR to use existing Quote
  353.      Tracks, skipping the Prodigy commands to create new ones.
  354.