home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_door / msimart.arj / BBSMART.DOC < prev    next >
Text File  |  1992-03-21  |  21KB  |  475 lines
  1.  
  2.                     ╓───────┐  ╓─────┐  ╓───┐
  3.                     ║ ╒╗ ╒╗ │  ║ ╒═══╛  ╚╗ ╒╛
  4.                     ║ │║ │║ │  ║ └───┐   ║ │
  5.                     ║ │╚═╛║ │  ╚═══╗ │   ║ │
  6.                     ║ │   ║ │  ╓───╜ │  ╓╜ └┐
  7.                     ╚═╛   ╚═╛  ╚═════╛  ╚═══╛
  8.                     Mountain State InfoSystems
  9.                     P. O. Box 6234
  10.                     Wheeling, WV 26003
  11.  
  12.                  ╔══════════════════════════════╗
  13.                  ║ BBS Stock Market Version 1.0 ║
  14.                  ╚══════════════════════════════╝
  15.  
  16.                A Door Game Program for BBS Systems
  17.  
  18.                * WV\OnLine BBS * (304) 233-4199 *
  19.             * Wheeling, WV * Robert Ducker, Sysop *
  20.  
  21.  
  22.                            █▐*█▀█ ▐*█  █ ▐*█▀▀▀
  23.                             ▐*█   ▐*█▄▄█ ▐*█▄▄▄
  24.                             ▐*█   ▐*█  █ ▐*█▄▄▄
  25.  
  26.             ▐*█▀█▀▄ ▐*█▀▀▀ ▐*█▀▀▀ ▐*█▀▀█ ▐*█     ▀▐*█▀ ▐*█▀▀█ █▐*█▀█
  27.             ▐*█ █ █ ▐*█▄▄▄ ▐*█ ▄▄ ▐*█▄▄█ ▐*█      ▐*█  ▐*█▄▄▄  ▐*█
  28.             ▐*█ █ █ ▐*█▄▄▄ ▐*█▄▄█ ▐*█  █ ▐*█▄▄█  ▄▐*█▄  ▄▄▄▄█  ▐*█
  29.  
  30.                            ▐*█▀█  ▐*█▀█  ▐*█▀▀█
  31.                            ▐*█▄█▄ ▐*█▄█▄ ▐*█▄▄▄
  32.                            ▐*█▄▄█ ▐*█▄▄█  ▄▄▄▄█
  33.  
  34.               (304) 797-0277 * Weirton, WV * Aldo Pucci, Sysop
  35.  
  36.             (C) Copyright Mountain State InfoSystems 1991, 1992
  37.                       by Robert Ducker and Aldo Pucci, Sr.
  38.  
  39.  
  40.                                 P R E F A C E
  41.                                --------------
  42.  
  43. The BBS Stock Market software and this document are (c) Copyright 1991,
  44. 1992 Mountain State InfoSystems by Robert Ducker and Aldo Pucci, Sr. All
  45. rights reserved.
  46.  
  47. Brand and product names are trademarks or registered trademarks of their
  48. respective holders. Default company names found in this game program
  49. are fictitious.
  50.  
  51.  
  52.                       A    N O T E    O F    T H A N K S
  53.                      ----------------------------------
  54.  
  55. *  The great WV\OnLine callers and those who tested this software:
  56.    Danny Crews, Jack Greenwood, James Budddenberg, Jon Whitehouse,
  57.    Scott McGee and others.
  58. *  Friends and family who tolerate my disappearances to work on
  59.    computer software.
  60.  
  61.      Thanks are also extended to my partner, Aldo Pucci, who
  62.    provided me with good "constructive criticism," and who got me
  63.    started BBS'ing.
  64.  
  65.                           User Supported Software
  66.                           -----------------------
  67.  
  68.         This  program is  distributed  under the User  Supported
  69.   Software Concept.   User Supported Software is a way to allow you
  70.   to review the program,  test  its operation on your system
  71.   configurations, and  determine whether  or  not you feel the
  72.   program  is suitable  for you and your users before you have to
  73.   register it.
  74.  
  75.         If you find that BBS Stock Market fulfills your needs, you must
  76.   register your copy. If you do not register it, then you must stop running
  77.   it.  Registration is mandatory if you decide to use the program and wish
  78.   support from the author.  Registration may be obtained by mailing
  79.   to Mountain State InfoSystems the order form included in the
  80.   MSIMART.ZIP file, along with $15.
  81.  
  82.                            BBS Stock Market Files
  83.                           ----------------------------
  84.  
  85.      The following files were distributed by Mountain State
  86.   InfoSystems in the MSIMART.ZIP file:
  87.  
  88.      BBSMART.EXE  -- The executable program file to start BBS Stock Market
  89.  
  90.      RUNMART.CNF  -- ASCII configuration file you will need to modify
  91.                      for your system
  92.  
  93.      STOCK.DAT -- Data file with initial stock information
  94.  
  95.      CALLER.HLP  -- Data file for help screens
  96.  
  97.      MENU.HLP -- Menu assistance screens
  98.  
  99.      BBSMART.CLR/.BBS -- Game logon screens
  100.  
  101.      BBSMART.DOC -- This documentation file
  102.  
  103.      ORDER.DOC -- Order form for BBS Stock Market
  104.  
  105.   If this .ZIP file did not pass Pkunzip's Auto Verification when you
  106. unzipped it then I recommend that you discard all related files and call
  107. WV\OnLine for a good copy.
  108.  
  109.  
  110.       Shareware vs. Registered Version of BBS Stock Market
  111.       ----------------------------------------------------
  112.  
  113.      The shareware version (1.0) of BBS Stock Market has the
  114. following characteristics not found in the registered version:
  115.                           --- ----- -- --- ---------- -------
  116.  
  117.       1) The logon informational screens presented will read
  118.          "Unregistered's BBS Stock Market" instead of your BBS's name.
  119.  
  120.       2) You can not customize the stock names, prices, availability,
  121.          etc. and you can not manipulate the users's file or stock
  122.          file to fine-tune the game to your board's call volume.
  123.  
  124.     REGISTRATION will correct the above constraints PLUS:
  125.  
  126.       1) Bring you unlimited technical support via WV\OnLine.
  127.  
  128.       2) Entitle you to free upgrades via modem for ALL FUTURE
  129.          VERSIONS of BBS Stock Market.
  130.  
  131.       3) Registration also entitles you to download the accessory
  132.          program, MyMart, that will allow you to customize and better
  133.          maintain BBSMART.  This program allows you to monitor user
  134.          positions, delete users, rename the stocks to names of your
  135.          choice and more; all through a pull-down menu system.
  136.  
  137.       4) BBSMART registration entitles you to a one year subscription
  138.          for your BBS to The MegaList at no additional cost.
  139.  
  140.  
  141.                           Registration
  142.                           ------------
  143.  
  144.      Registration is a very easy process.  Included in the
  145. MSIMART.ZIP file is a document called ORDER.DOC.  Simply print
  146. out the form, fill it out, and send it with your check or money
  147. order or VISA / Mastercard information to the address listed on the
  148. form.
  149.  
  150. Upon registration you will be added as a WV\OnLine paid subscriber with
  151. sysop status. If you call WV\OnLine you should check out Support Door
  152. for Sysops and Demo Doors.
  153.  
  154.                          About BBS Stock Market
  155.                          ----------------------
  156.  
  157.      BBS Stock Market is a stock market simulation. The following
  158. operational descriptions duplicate information which will be available to
  159. your callers through the help screens:
  160.  
  161.                     GENERAL CONCEPT
  162.  
  163. BBS Mart is a stock market simulation. You begin your stock trading
  164. career with $10,000 in cash and your goal is to triple your money by
  165. buying and selling common stocks.
  166.  
  167. Simply stated, you will want to make money by buying stocks and then
  168. selling them later for more than you paid for them, thus realizing a
  169. profit.
  170.  
  171. BBS Mart will help you monitor the status of your cash and stock
  172. holdings and will advise you when their combined value has equaled
  173. or surpassed your investment goal of $30,000.
  174.  
  175. When you reach your goal your skill level rating will be increased
  176. by one (1) and your investment position will be re-started with
  177. $10,000 in cash and no stocks. You will then resume your investment
  178. career at your new, higher skill level.
  179.  
  180. The key to successful stock trading is to select stocks for purchase
  181. that you feel are likely candidates to rise in value while avoiding
  182. stocks that may be about to fall in value.
  183.  
  184. It is also important to recognize when to take your profits and also
  185. to admit when you have made a mistake as you watch your investments
  186. fall in value.
  187.  
  188. As there are no trading commissions in BBS Mart, there is no reason
  189. not to switch to cash or to other stocks when your purchases are not
  190. performing as you had hoped they would.
  191.  
  192. It is advisable to monitor your trading position as often as you
  193. can. This will serve as insurance against your trading position
  194. getting out of control on the downside and will also help protect
  195. the skill level you have achieved.
  196.  
  197. If you should find yourself in a position where your investments
  198. seem to be stuck in the basement and your cash is low, you will want
  199. to consider resetting your account.
  200.  
  201. If you select this option you will be advised that all of your stock
  202. holdings are about to be liquidated and that your cash will be
  203. adjusted to $10,000.
  204.  
  205. If you elect to continue the reset process your skill level will
  206. also be reduced by one (1). Therefore, try to refrain from selecting
  207. this option until you are certain that you are stuck in your current
  208. position and that you are missing out on a major market upturn.
  209.  
  210. It is also important to monitor your trading position often so that
  211. you may be credited with a higher skill level as soon as you have
  212. reached your investment goal.
  213.  
  214. You should NOTE that should the value of your cash and stocks rise
  215. above your goal and then fall back below your goal before you have
  216. called in to check, then you will not receive credit to your skill
  217. level for having surpassed your investment goal.
  218.  
  219.                   You must be present to win!
  220.  
  221. To be successful you must pay attention to what the informational
  222. screens are telling you and must not be afraid to take a risk.
  223.  
  224.                     Have a good trading day!
  225.  
  226.  
  227.                     MENU FUNCTIONS
  228.  
  229.  BUY STOCKS:  Use this function when you are ready to buy some shares.
  230.      You will be provided with a display of all listed stocks along with
  231.      some information about their present status.  Each stock may be
  232.      identified by a reference number which you will see  to the left of
  233.      the stock name. Use this number to indicate which stock you wish to
  234.      purchase. After you have selected a stock for purchase  you will be
  235.      asked to enter the number of shares you are buying. If that company
  236.      has shares available and you have not requested a purchase which is
  237.      greater than your available cash then your buy order will be
  238.      precessed immediately. Please note that should a stock fall below $5
  239.      per share in value then buy orders will be suspended in that
  240.      company's shares until they return to $5 per share or higher.
  241.  
  242.  YOUR FINANCES:  This function will display a screen which summarizes
  243.      your financial position. Your cash and the value of  your stock
  244.      positions will be totaled. Your skill and the amount needed to reach
  245.      your goal will also  be listed.
  246.  
  247.  GET QUOTES:  These selections cause the Stocks Quote Screen to be
  248.  MORE QUOTES  displayed. The stock names are listed along with each
  249.      stock's high and low quote since the last time an investor reset their
  250.      account or the last time someone  reached their goal and achieved a
  251.      higher BBS Mart skill level. The center of the display serves as a
  252.      quick reference which shows the number of shares you own for each
  253.      company plus your current gain or loss. The right side of the display
  254.      shows the number of investors who own shares of each company plus the
  255.      number of shares that remain available for purchase. MORE QUOTES
  256.      should be used to toggle the display screen between the first and
  257.      second twelve stocks. The rightmost column repeats the stock names to
  258.      facilitate reading accross the wide rows of information.
  259.  
  260.  INFO: Is available from the Buy Stocks Screen. If you want additional
  261.     information on a stock you are considering  for purchase just type the
  262.     stock's number as indicated  on the display screen and then type
  263.     "Info".
  264.  
  265.  Account Reset: Use this function as a last resort when your trading
  266.     position has become hopeless and your cash is low. Any stocks that you
  267.     own at the time will be disposed of and your cash will be restored to
  268.     $10,000.  Also, your BBS Mart skill level will be reduced by one. You
  269.     will resume at your new skill level.
  270.  
  271.  SELL STOCKS: This is how you take your profits or cut your losses.
  272.    You will be provided with a display of all listed stocks along with some
  273.    information about their present status.  Each stock may be identified by
  274.    a reference number which you will see to the left of the stock name. Use
  275.    this number to indicate which stock you wish to sell. After you have
  276.    selected a stock to sell you will be asked to enter the number of shares
  277.    you are selling. You may sell all the shares you own or just a portion
  278.    of them.  Your cash will be credited for the full amount of your sell
  279.    order.
  280.  
  281.  MARKET WATCH: This screen presents some statistics that will give
  282.    you a snapshot view of where the general market is going.  The
  283.    information includes the total market value and current average share
  284.    price. You will also see the  current session number and the total
  285.    number of trades to-date plus the current session's volatility rating is
  286.    indicated.
  287.  
  288.  YOUR STOCKS:  The Your Stocks screen lists vital information about
  289.    the stocks you currently own. The current quote for each stock you hold
  290.    is provided as well as your cost for each position and its actual value
  291.    as of the last quote.  Your gain or loss for each position is calculated
  292.    and any news that is currently affecting each stock's performance is
  293.    indicated.
  294.  
  295.                       -----------------------------------
  296.  
  297.      The features of BBS Stock Market (Version 1.0) include:
  298.  
  299.      <1> Compatibility with systems that are compatible with
  300.             PCBOARD.SYS, USERS.SYS, DOOR.SYS, CALLINFO.BBS,
  301.             DORINFOx.DEF, CHAIN.TXT, or SFDOORS.DAT for interfacing
  302.             to the BBS.
  303.  
  304.      <2> Generates an online "Top Ten Current Scores" bulletin, as well as
  305.             BBSMART.BLT (ASCII) and BBSMARTG.BLT (ANSI) files the can be
  306.             copied to other BBS files on your system.  (Like the bulletin
  307.             section)
  308.  
  309.      <3> BBS Stock Market will exit back to the BBS if it detects
  310.          no keyboard activity for 4 minutes. At input prompts,
  311.          it will return to the BBS after 3 minutes of inactivity.
  312.  
  313.      <4> BBS Stock Market automatically determines if the
  314.             remote system has color capability. If it does, the
  315.             user will see color graphics screens, otherwise,
  316.             monochrome graphics will be sent. Non-ANSI callers
  317.             will be immediatley returned to the board.
  318.  
  319.  
  320.                      Setting Up BBS Stock Market
  321.                      ---------------------------------
  322.  
  323.      A file called RUNMART.CNF was sent with the MSIMART.ZIP
  324. distributed by Mountain State InfoSystems.  This file must be
  325. edited, using your favorite text editor, for the program to operate
  326. properly.
  327.  
  328. Currently, RUNMART.CNF like this:
  329.  
  330. C:\SF\SFDOORS.DAT       <- Location of SFDOORS.DAT  ! or see below !
  331. WV\Online                    <- BBS name
  332. Robert                       <- Sysop's first name
  333. Ducker                       <- Sysop's last name
  334. C:\WCWORK\NODEx              <- For WildCat! 3.0+ users only.
  335.                                 Location of work directory
  336.  
  337.  
  338. The format for RUNMART.CNF is detailed below.  As above, there must
  339. be no blank lines.
  340.  
  341. For Line 1 choose one of the following
  342. --------------------------------------
  343. C:\PCB\PCBOARD.SYS              <- For PCBoard systems using PCBOARD.SYS
  344.                                    only.
  345. C|\PCB\USERS.SYS                <- For PCBoard systems using USERS.SYS
  346. C:\BBS\CALLINFO.BBS             <- For Wildcat! systems (prior to v3.0)
  347. C:\BBS\DOOR.SYS                 <- For systems that support DOOR.SYS
  348. C:\BBS\DORINFOx.DEF             <- For QBBS/RBBS/RA. Replace x with Node #.
  349. C:\BBS\SFDOORS.DAT              <- For Spitfire systems.
  350. For Remaining Lines
  351. -------------------
  352. WV\OnLine                       <- BBS name
  353. Robert                          <- Sysop's first name
  354. Ducker                          <- Sysop's last name
  355.  
  356. NOTE: BBSMART supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  357.       COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  358.       number after the configuration filename. Let's assume your are
  359.       running BBSMART on COM1 and IRQ5. The command line passed to your
  360.       Door would be:
  361.                         BBSMART RUNMART.CNF /5
  362.  
  363.       The /5 tells BBSMART to use IRQ5 rather than the standard IRQ4 that
  364.       is normally used with COM1. No /x parameter is needed for the
  365.       standard IRQ's.
  366.  
  367.  
  368.                       Running BBS Stock Market
  369.                       ------------------------
  370.  
  371.      First, create a directory called "BBSMART".  Then copy all of the
  372. files in MSIMART.ZIP into it.
  373.  
  374.      The following command must be present in the file you use to
  375. invoke door programs:
  376.  
  377.            CD\SF\BBSMART         <- Path where the BBSMART files reside
  378.            BBSMART RUNMART.CNF
  379.  
  380. That's it!
  381.  
  382. BBS Stock Market creates a file called USERS.DAT that contains
  383. the players' names and status information.  It also creates a
  384. file called DFRAME.ERR, which will list any errors that the program
  385. might have encountered.  It you get errors, please bring them to my
  386. attention.
  387.  
  388.                         Resetting BBS Stock Market
  389.                         --------------------------
  390.  
  391. Save a copy of the original STOCK.DAT to be used when you wish to restart
  392. BBSMART.  To reset BBS Stock Market, delete the Users.dat file
  393. and the STOCK.DAT file from the BBSMART directory. Then copy an original
  394. STOCK.DAT (unused) to the BBSMART directory. Then delete all the .BUL and
  395. .BLT files.  If you simply wish to reset the scores, delete BBSMART.BUL
  396. file. The accessory program, MyMart, will be available to you after you
  397. register BBS Mart and will automate the reset process.
  398.  
  399.                                   L I C E N S E
  400.                                   -------------
  401.  
  402. BBS Stock Market is not a Public Domain Program and is not
  403. free to the Public. BBS Stock Market is (c) Copyright, 1991,
  404. 1992, Mountain State InfoSystems by Robert Ducker and Aldo Pucci.
  405.  
  406. BBS Stock Market may NOT be modified in any way, for any
  407. reason, including but not limited to, de-compiling, disassembling,
  408. or reverse engineering of the program.  The opening title screen
  409. and all other proprietary program output must never be altered,
  410. removed, bypassed, or modified by any means.
  411.  
  412. You are free to distribute the PUBLICLY AVAILABLE shareware version
  413. of BBS Stock Market to others subject to the above restrictions
  414. and also the following:
  415.  
  416.      a. No fee is to be charged for its use;
  417.  
  418.      b. No renumeration may be accepted for BBS Stock Market.
  419.           This does not apply to computer access charges the system
  420.           operators of or organizations owning bulletin board
  421.           systems (BBS's), online services, etc...may charge
  422.           to subscribe.
  423.  
  424.      c. BBS Stock Market must be copied in unaltered form,
  425.           complete with files containing license information, the
  426.           FULL documentation, and all accompanying files.
  427.  
  428.      d. All shareware houses/distribution firms must make
  429.           explicitly clear that the diskette purchase containing
  430.           any shareware program has NOT registered the shareware
  431.           with Mountain State InfoSystems.
  432.  
  433. System Operators may make BBS Stock Market available for
  434. download only if the above conditions are met.  The "zipped" archive
  435. (MSIMART.ZIP) distributed by Mountain State InfoSystems may be made
  436. available only in complete form.
  437.  
  438. Commercial distributors of "Public Domain," "Shareware," and/or
  439. User Supported software may distribute BBS Stock Market subject
  440. to the above conditions only after obtaining WRITTEN permission
  441. from Mountain State InfoSystems.
  442.  
  443. The above license statement does not apply to the REGISTERED
  444. version of BBS Stock Market.  The shareware and registered
  445. versions of software from Mountain State InfoSystems are protected under
  446. the United States Copyright and Trademark Laws.
  447.  
  448.                                  DISCLAIMER
  449.                                  ----------
  450.  
  451.           Mountain State InfoSystems (MSI) disclaims all warranties
  452. relating to this software, whether express or implied, including
  453. any implied warranties of merchantability or fitness for a particular
  454. purpose. MSI will not be liable for any special, incidental, consequential,
  455. indirect or similar damages for any reason; regardless of any knowledge on
  456. our part of the possibility for such damages. In no event shall MSI's
  457. liability for any damages ever exceed the price paid for the license to use
  458. software, regardless of the form of the claim.  The person using the
  459. software bears all risk as to the quality and performance of the software.
  460.  
  461. Hope you'll enjoy BBS Stock Market!!
  462.  
  463.  
  464. Bob Ducker
  465.  
  466. ---------------------------------------------------
  467. MICROSOFT(R) QuickBASIC Version 4.5 for
  468. IBM(R) Personal Computers and Compatibles
  469. (C)Copyright Microsoft Corporation, 1988
  470.  
  471. DOORFRAME 2.7 Doors Development Library
  472. (C)Copyright, 1992, Ted Freeman
  473.  
  474.  
  475.