BB STOCK TOOL Release 1.3.1 README 

Files
=====
    README -- information and installation
    bb_doc.ps -- bb document, user's guide in PostScript
    order_form -- use this form to order BB tool license

NOTE: 
a)  Linux version is for libc-4.6, XFree 3.1.1
    To find gcc libc version, use "ls -l /lib/libc.so.4"


Installation
============
To install in Linux environment:

Using $HOME/stk1.3 as the BB Stock Tool's root directory
    $ cd ~
    $ tar zxf bb_stock.tar.gz
    $ cd stk1.3/etc
    $ ./instkey
    Please enter authorization code: [enter authorization code]*

* Please see the last section of this file for the authorization code.


Setup Environment
=================
BB tool needs an environment variable STOCK_HOME, which is the root
directory of BB.

o sh/ksh users
    $ export STOCK_HOME
    $ STOCK_HOME=$HOME/stk1.3

    Put the following into $HOME/.profile
    STOCK_HOME=$HOME/stk1.3
    export STOCK_HOME

o csh users:
    % setenv STOCK_HOME $HOME/stk1.3

    Put the following into $HOME/.login
    setenv STOCK_HOME $HOME/stk1.3

To setup MANPATH
    MANPATH=$MANPATH:$HOME/stk1.3/man

You may want to setup PATH to include BB Tool's commands
    PATH=$PATH:$HOME/stk1.3/bin


Ready to Run
============
Run BB tool, set the background color as gray:
    $ ~/stk1.3/bin/bb -bg gray

Click on either of the two leftmost icons which looks 
like a page with folded corner in the toolbar to load stocks.

NOTE:
o If you get error message "libXmu.so.4: can't open file"
  Enter "ldd bb" to see what libraries are missing, then
  find the pathname of the libraries, for instance, /usr/openwin/lib
  then setup LD_LIBRARY_PATH
  LD_LIBRARY_PATH=/usr/openwin/lib:$LD_LIBRARY_PATH

o If you get error message "Unknown keysym name: osfRight", etc.
  Try download XKeysymDB from ftp.portal.com.

o If you get "license file not found".  It is most likely that
  you did not install license file correctly.  See section 
  on Installation.

o If BB Tool could not start and gave error message:
  Warning: Cannot allocate colormap entry for "Green3"
  Warning: Cannot allocate colormap entry for "#b7c1e5"

  X Error of failed request:  BadDrawable (invalid Pixmap or Window parameter)
  Major opcode of failed request:  14 (X_GetGeometry)
  Resource id in failed request:  0x0
  Serial number of failed request:  1009
  Current serial number in output stream:  1009

  It is due to some other applications, such as Mosaic, netscape have
  exhausted the colormap cells.  You may quit those applications and
  BB Tool can run properly.


Historic Quote
==============
Evaluation package contains all the functionalities of a licensed
version.  It comes with up-to-date historic stock quotes on five
stocks (Apple, Bay Network, Cisco, IBM and Sun Microsyststems) and DJ
Industrial average for your evaluation.

If you would like to evaluate other stocks on any US Stock Exchange, you
may order it from Falkor Technologies at US$1.00 per stock.  Each
historic stock quote contains daily high, low, closing and volume for
about two years.


Daily Quote
===========
Falkor Technologies provides FREE BB Daily Quote Service to its users; 
the quote is sent to individual users of BB tool via email at the end of 
each trading day.

You can register to receive BB daily quote via email. To register,
simply send an email to ctor@shell.portal.com with "Subject: Quote", and
list your stock symbols in the mail, one symbol per line; the maximum
is 200 stock symbols.

    $ mail ctor@shell.portal.com
    Subject: Quote
    AAPL
    BNET
    CSCO
    IBM
    SUNW
    <end_of_file>

When your BB daily quote arrives, you can save the email into a file.  
To update your historic quote database, you may do it either from BB 
Tool or from command line.

1. In BB Tool, use "Edit => Update Stock Data...".
2. From command line, use fmttic command in $STOCK_HOME/bin

The usage of fmttic is "fmttic <filenames>", fmttic accepts one or
more files and it won't add any redundant record into the historic
quote database.

    $ fmttic t1026.dat t1027.dat t1028.dat
 or $ fmttic t*.dat


Authorization Code
==================
Authorization Code: ITYKDXC2CLVZ273I
This authorization code is for June 5, 1995
it expires on July 3, 1995

If the above authorization code has expired, please send e-mail to 
ctor@shell.portal.com for authorization code.
