home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / t / tsblue31.zip / TSBLUES.DOC < prev    next >
Text File  |  1993-03-04  |  16KB  |  366 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         The Token Street Blues Stock Market Simulation
  8.                 Version 3.1 Production Release
  9.                   A Multiplayer Door Program
  10.  
  11.                   (c) Copyright 1989-1993 By
  12.                       Glen R. Fredericks
  13.                      All Rights  Reserved
  14.  
  15.                 Latest Versions Available From
  16.                       The Token Ring BBS
  17.                  201-546-1468   USR DS  14400
  18.                  201-478-6448   USR HST 14400
  19.  
  20.  
  21.                          Description
  22.                          -----------
  23.      The Token Street Blues is a multi-player stock market
  24. simulation door designed to closely mimic and operate like a
  25. real stock market.  Players compete based on achieving the
  26. highest annualized rate of return on their initial $10,000 in
  27. play money.  Noteworthy aspects of the door include, but are
  28. not limited to, the following:
  29.      - daily maintenance program which leaves nothing for the
  30.        sysop to do
  31.      - realistic price fluctuations reflective of probability
  32.        factors contributed by company news releases and
  33.        general economic climate
  34.      - discount broker commission rates on purchase and sale
  35.        of securities and options
  36.      - broker messages to inform players of news about their
  37.        holdings or margin calls or margin sales
  38.      - news generator which creates news for companies
  39.        affecting their day to day price performance
  40.      - general economic new generator which creates news
  41.        affecting the overall trend of the market
  42.      - 60 day price history including shares currently
  43.        outstanding for all issues on the exchange
  44.      - 60 day price history for the general market including
  45.        the current market capitalization
  46.      - current price, 60 day high and low, shares outstanding
  47.        listing
  48.      - graphical display of the most recent 15 days price
  49.        performance for each issue
  50.      - complete account maintenance and portfolio analysis
  51.        for all players
  52.      - a financial newspaper which maintains the most recent
  53.        100 news items concerning companies and the general
  54.        market
  55.      - margin accounting for all players, including margin
  56.        calls and automatic sell off after 5 consecutive
  57.        margin calls
  58.      - occasional prime rate changes which affects the trend
  59.        of the market and the interest paid on cash balances
  60.        and margin debt
  61.      - player rankings based on annualized return so that a
  62.        player may start the game at any time
  63.      - online instructions and command summary
  64.      - short selling of securities
  65.      - options trading of calls and puts
  66.      - exchange report on issues listing activity in a stock
  67.  
  68.                         Sysop Features
  69.                         --------------
  70.      The Token Street Blues has the ability to carry on a
  71. CHAT (using the F10 key) with the user while he is inside the
  72. door. The F8 key can be used to force a player out of the
  73. door and back to the main bbs. The F9 key allows the sysop to
  74. toggle the local display screen on and off.  This door has
  75. been designed to be self-maintaining thereby requiring little
  76. if any intervention on the part of the sysop.
  77.  
  78.                      System Requirements
  79.                      -------------------
  80.      The successful operation of this program will require
  81. the following:
  82.  
  83.             IBM-PC or 100% Compatible Computer
  84.             PCBoard 14.x Software or BBS software compatible
  85.                with PCBoard Door programs or BBS software
  86.                which uses the DOOR.sys caller information
  87.                file.
  88.  
  89.                         Files Required
  90.                         --------------
  91.      The operation of this program requires the presence of
  92. the following files:
  93.  
  94.      Token Street Door Subdirectory
  95.      ------------------------------
  96.      BRUN45.exe   ==> QB4.5 Run Time Module
  97.      TSBLUES.exe  ==> Executable Program File Ver.  x.x
  98.      TSMAINT.exe  ==> Token Street Daily Maintenance Program
  99.      TSREPORT.exe ==> Token Street Blues Reporter/Editor
  100.      TS.cfg       ==> Token Street Configuration File
  101.      TSSTOCKS.dat ==> Token Street Company Datafile
  102.      TSTRADER.dat ==> Token Street Player Datafile
  103.      TSOWNERS.dat ==> Token Street Owners Datafile
  104.      TSOPTION.dat ==> Token Street Option Datafile
  105.      TSNEWS.dat   ==> Token Street News Datafile
  106.      TSSMSG.dat   ==> Token Street Messages To Sysop
  107.      TSPMSG.dat   ==> Token Street Player Messages
  108.      TSHELP.doc   ==> Token Street Player Instructions
  109.      TSOPEN       ==> Opening Message File (Asci)
  110.      TSOPENG      ==> Opening Message File (Ansi)
  111.      TSCLOSE      ==> Closing Message File (Asci)
  112.      TSCLOSEG     ==> Closing Message File (Ansi)
  113.  
  114.      BBS Files
  115.      ---------
  116.      PCBOARD.sys     \
  117.        or             >==>  User file created by BBS software
  118.      DOOR.sys        /
  119.      EVENT.sys       ==>  Timed Event Batch File
  120.  
  121.      The following files should have been included in the
  122. distribution archive:
  123.  
  124.      TSSETUP.exe  <-- Token Street Initialization Program
  125.      TSBLUES.exe  <-- Executable Program File Version x.x
  126.      TSMAINT.exe  <-- Token Street Daily Maintenance Program
  127.      TSREPORT.exe <-- Token Street Blues Reporter/Editor
  128.      BRUN45.exe   <-- QB4.5 Run Time Module
  129.      TS1.cfg      <-- Sample Configuration File Node 1
  130.      TS2.cfg      <-- Sample Configuration File Node 2
  131.      TSBLUES.doc  <-- Sysop Documentation
  132.      TSHELP.doc   <-- Token Street Player Instructions
  133.      TSBLUES      <-- Sample DOOR batch file
  134.      TSSETUP.ini  <-- Token Street Initialization Datafile
  135.      TSOPENG      <-- Ansi Welcome Screen
  136.      TSOPEN       <-- Asci Welcome Screen
  137.      TSCLOSEG     <-- Ansi Closing Screen
  138.      TSCLOSE      <-- Asci Closing Screen
  139.      README.doc   <-- Read this before doing anything
  140.  
  141.     OPTIONS.exe has been provided for those currently running
  142. previous versions of The Token Street Blues Door which did not
  143. support options trading.  Options.exe will create the datafile
  144. necessary for options trading so that reinitialization is un-
  145. necessary.  If there is not a TSOPTION.dat file in your Token
  146. Street subdirectory, you must either run options.exe OR
  147. reinitialize to use this release of The Token Street Blues
  148. Door.
  149.  
  150.                         Initialization
  151.                         --------------
  152.      The Token Street Blues data files must be created and
  153. initialized prior to operation of the door. The program
  154. TSSETUP.exe and a sample data file TSSETUP.ini have been
  155. provided for this purpose.  While in the Token Street
  156. subdirectory location and in the presence of the TSSETUP.ini
  157. datafile (see note below regarding customization of the Token
  158. Street exchange companies) execute the program TSSETUP.exe.
  159. Supply the password for entry into the editor and let the
  160. program run (a few minutes).  After completing the setup,
  161. both the TSSETUP.ini and TSSETUP.exe files may be removed.
  162. You should run TSMAINT immediately after initializing.
  163.  
  164.                         Customization
  165.                         -------------
  166.      The file TSSETUP.ini contains the company ticker symbol
  167. and name and the initial prices for all the issues on the
  168. exchange. You may have up to 250 companies listed, however,
  169. you may want to start out with only 15-25 and add companies
  170. as the market volume grows. Use the format in the supplied
  171. TSSETUP.ini if you choose to customize at this time.
  172.  
  173.                       Program Operation
  174.                       -----------------
  175.      The file TS.cfg must contain the following information
  176. as a minimum for proper program operation:
  177.  
  178.      Registration#      --> Place your Token Street Blues
  179.                             registration number here
  180.      d:\Pcboard.sys or d:\door.sys
  181.                         --> The complete drive\sub-directory
  182.                             path to the system file
  183.                             PCBOARD.sys or DOOR.sys
  184.      BBS Name           --> The Name of your BBS System
  185.      d:\PCB\GEN\blt     --> A complete drive\sub-directory\
  186.                             filename for the top 10 bulletin
  187.                             Do not use an extension!
  188.                             Maximum length is 7 characters!
  189.      mm                 --> The number of minutes a user will
  190.                             be allowed in the door.  A value
  191.                             of 0 defaults the time to that
  192.                             remaining on the board.
  193.  
  194.      A sample configuration file is included to provide help
  195. in implementing Token Street. The configuration file may be
  196. created with any good text editor such as edlin or many word
  197. processing programs.
  198.  
  199.           TS.cfg
  200.           ----------
  201.           XX1234
  202.           C:\PCB\PCBoard.sys (or DOOR.sys)
  203.           The Token Ring BBS
  204.           C:\PCB\GEN\BLT19
  205.           30
  206.  
  207.      The configuration file must be located in the default
  208. directory along with the required files mentioned above.
  209. Since the name of the configuration file is not hard coded
  210. Into the program, you may name the configuration file
  211. anything you desire.  However, since this flexibility is
  212. built into the software, the name of the configuration file
  213. must be passed to the program at the time of invocation from
  214. the door batch file used to run the program.
  215.  
  216.                     Invocation Batch File
  217.                     ---------------------
  218.      Each door program which runs under PCBoard or other BBS
  219. systems must have a batch file associated with it which
  220. carries out the necessary housekeeping tasks for PCBoard.
  221. This file changes directory areas if necessary, invokes the
  222. program and passes necessary parameters, and returns the user
  223. to PCBoard when the door function is completed.  An example
  224. invocation batch file is included.
  225.  
  226.           TSBLUES  ---->  Sample Door Batch File
  227.           -------
  228.           echo off
  229.           cd c:\pcb\tsblues
  230.           tsblues ts.cfg    (use tsx.cfg for multinode
  231.           cd c:\pcb operation)
  232.           board
  233.  
  234.  
  235.                       Daily Maintenance
  236.                       -----------------
  237.      TSMAINT.exe is the daily maintenance program which
  238. performs the important tasks of computing stock price
  239. movements, generating company specific news releases and
  240. recording associated probability factors, sending broker
  241. messages and margin calls to players, packing the broker
  242. message base, deleting inactive players and generating
  243. general economic news. For proper operation of Token Street,
  244. this program must be located in the Token Street subdirectory
  245. and run at least once per day.  It is conveniently run from
  246. within the PCBoard event.sys on a daily basis, e.g.
  247.  
  248.            EVENT.sys  <---  Insert within Event.sys
  249.            ---------
  250.            ..
  251.            cd c:\pcb\tsblues
  252.            tsmaint c:\pcb\gen\blt19
  253.            cd c:\pcb
  254.            ..
  255.  
  256.      The path and filename for the top ten player bulletin is
  257. optional and may be included in the TSMAINT command line as
  258. shown above.
  259.  
  260.  
  261.                  Token Street Editor/Reporter
  262.                  ----------------------------
  263.      The editor allows the sysop to add new companies to the
  264. exchange, view player records and holdings, view company
  265. records and individual holders and view the messages to the
  266. sysop. The editor may be entered by the SYSOP from Token
  267. Street or you may alternatively set it up as a separate door
  268. in the same way that Token Street is configured.
  269.  
  270.  
  271.                   Ctty/Watchdog/Carrier Loss
  272.                   --------------------------
  273.      Ctty and Watchdog are not required for use of this
  274. program.  The program contains its own built in communication
  275. routines and monitors the com port to insure carrier is
  276. present.  If carrier should drop for any reason the user is
  277. returned to pcboard where appropriate action is taken by the
  278. BBS software to log the user off the system.
  279.      NOTE: The use of watchdog or similar programs which
  280.      reboot the system may result in the incomplete update of
  281.      a players record on loss of carrier.
  282.  
  283.  
  284.                      Multinode Operation
  285.                      -------------------
  286.      PLEASE NOTE: Multinode operation is not currently fully
  287.      operational.  The program is capable of multinode
  288.      operation.  If it is used in a multinode configuration
  289.      then a separate configuration file must be maintained
  290.      for each node of the system.  If you are running in a
  291.      network environment also it will be necessary to pass an
  292.      additional parameter to the program in the door batch
  293.      file which is used to invoke the program  the command
  294.      line should also contain the /NETWORK parameter.
  295.  
  296.                    TSBLUES TSx.cfg /NETWORK
  297.  
  298.      Where the "x" is the node number the program is running
  299.      on. The reason for passing this parameter is so that the
  300.      network file/record locking mechanisms in the program
  301.      may be activated in order to properly function in a
  302.      network environment.
  303.  
  304.  
  305.                    User Supported Software
  306.                    -----------------------
  307.      This version and all previous versions of The Token
  308. Street Blues Stock Market Simulation Door are NOT public
  309. domain and are (c)copyrighted by Glen R. Fredericks with all
  310. rights reserved. It may NOT be distributed for personal gain
  311. under any circumstances.
  312.      The TSBLUExx.zip file in its original form may be copied
  313. and distributed thru bulletin board systems provided no fee
  314. is charged for its distribution and provided no modifications
  315. are made to the program and/or supplementary files contained
  316. therein.
  317.      User Supported Software is a way for you to review a
  318. program on a trial basis and test its operation on your
  319. system prior to purchasing it. Under this type of
  320. distribution system, you are insured that the program meets
  321. your needs and requirements prior to purchase and
  322. registration.
  323.     If after a trial period of up to 15 days you find that
  324. The Token Street Blues fulfills the needs and requirements of
  325. your system, you are REQUIRED to register your copy.  If you
  326. do not wish to register then you should cease use of the
  327. software product.  Please note that registration is mandatory
  328. and is a condition for continued use for this software.
  329.  
  330.  
  331.                  Miscellaneous - Please Read
  332.                  ---------------------------
  333.      If you have any problems, bug reports or questions
  334. concerning the use of this program, please contact me at The
  335. Token Ring BBS at 201-546-1468 (24 hours a day/7 days a
  336. week). I would greatly appreciate hearing from you with
  337. suggestions for improvements or other comments.  This will
  338. greatly assist me in the continued support and development of
  339. the Token Street Blues door. I thank you for your cooperation
  340. and hope that you and your callers enjoy the excitment of
  341. simulated stock market trading.  The latest version of this
  342. software can always be obtained from within the The Token
  343. Ring BBS Sysop's Conference.
  344.  
  345.           Glen R. Fredericks            The Token Ring BBS
  346.           109 E. 1st St.                201-546-1468
  347.           Clifton, NJ  07011            24 Hours PCPable
  348.  
  349. In extreme circumstances, you may contact me by voice at one
  350.  of the following numbers:    201-365-8568 (weekdays)
  351.                               201-340-1186 (all other)
  352.  
  353.  
  354.                           Disclaimer
  355.                           ----------
  356.      This software is provided on an "As Is" basis without
  357. warranty either implied or expressed of any kind.  Glen R.
  358. Fredericks, the author and sole owner of this software, takes
  359. no responsibility for loss of data or damage to equipment
  360. thru the use of this software.  Should the software prove
  361. defective the entire burden of any and all repairs and
  362. replacements and/or data restoration rests with the user.  In
  363. no event will the author be liable for any costs and/or
  364. losses either tangible or intangible arising from the use of
  365. this software.
  366.