BB STOCK TOOL Release 2.1 README 

Files
=====
    README -- information and installation
    bb_doc.ps.gz -- bb document, user's guide in PostScript
    order_form -- use this form to order BB Stock Tool license
                  and/or historic stock quotes
    stkdata.tar.gz -- sample up to date historic stock data

    bb_solaris.tar.gz -- for Sun/Solaris 2.X
    bb_sunos.tar.gz -- for Sun/SunOS 4.X
    bb_linux.tar.gz -- for PC/LINUX

    gunzip.sunos -- GNU unzip, for Solaris 2.X
    gunzip.solaris -- GNU unzip, for SunOS 4.X
    csco.gif -- snapshot of BB Stock Tool, use xv, xloadimage to view

NOTE: 
a)  use gunzip to unzip .gz file, for example:
    bb_doc.ps.gz is gzip compressed PostScript document
    It has 45 pages, to print it on a Laser Printer:
        gunzip bb_doc.ps
        lpr bb_doc.ps
b)  LINUX version is for libc-4.6 and XFree 3.1.1
    To find gcc libc version, use "ls -l /lib/libc.so.4"

Installation
============
To install in Solaris 2.X environment: You need to get
bb_solaris.tar.gz, stkdata.tar.gz and gunzip.solaris.

The installation procedures for SunOS 4.X and LINUX are similar.  For
SunOS 4.X, you need bb_sunos.tar.gz, stkdata.tar.gz and gunzip.sunos.
For LINUX, you need bb_linux.tar.gz and stkdata.tar.gz. gunzip is a
standard command on LINUX.

Assume using $HOME/stk2.1 as the BB Stock Tool's root directory
    $ cd $HOME
    $ mv gunzip.solaris gunzip
    $ chmod +x gunzip
    $ gunzip bb_solaris.tar.gz
    $ tar xvf bb_solaris.tar
    $ gunzip stkdata.tar.gz
    $ tar xvf stkdata.tar
    $ rm -f stk
    $ ln -s stk2.1 stk
    $ cd stk/etc
    $ ./instkey
    Please enter authorization code: [enter authorization code]*

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

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

The Sun SPARC version is based on X11R5.  If you don't have
/usr/lib/X11/nls directory on your system, you need to setup an
environment variable XNLSPATH to point to the nls directory, otherwise
cut/paste and tearing off a menu may cause core dump.  we have
included nls directory in our distribution, it is at
stk2.1/lib/X11/nls.  If you are using LINUX, you don't need to set
XNLSPATH environment variable.

o sh/ksh users
    $ export STOCK_HOME
    $ STOCK_HOME=$HOME/stk
    $ export XNLSPATH
    $ XNLSPATH=$STOCK_HOME/lib/X11/nls

    Put the following into $HOME/.profile
    STOCK_HOME=$HOME/stk
    export STOCK_HOME
    export XNLSPATH
    XNLSPATH=$STOCK_HOME/lib/X11/nls

o csh users:
    % setenv STOCK_HOME $HOME/stk
    % setenv XNLSPATH $STOCK_HOME/lib/X11/nls

    Put the following into $HOME/.login
    setenv STOCK_HOME $HOME/stk
    setenv XNLSPATH $STOCK_HOME/lib/X11/nls

To setup MANPATH
    MANPATH=$MANPATH:$HOME/stk/man

You may want to setup PATH to include BB Stock Tool's commands
    PATH=$PATH:$HOME/stk/bin

Migration from Previous Release
===============================
To migrate to Rel 2.1 from previous release, say Rel 2.0, after you
have completed the above installation procedure, do the following:

    $ cp ~/stk2.0/tic/_*_ ~/stk2.1/tic
    $ cp ~/stk2.0/lib/.[a-z]* ~/stk2.1/lib
    $ cp ~/stk2.0/etc/license.dat ~/stk2.1/etc
    $ cp ~/stk2.0/TRADE.LOG ~/stk2.1

Ready to Run
============
Run BB Stock Tool, set the background color as gray:
    $ ~/stk/bin/bb 

To load a stock, simply click on either of the two leftmost icons
which looks like a page with folded corner in the toolbar to load
stocks, you can also type Control-N to load a stock.  For more
information, please see the document.

NOTE:
o If you get coredump when tearing off "Load Stock" pull right menu or
  when you cut and paste on text field, you may not have "nls" directory
  installed on your system.  This directory is a standard part of the
  MIT X11R5 distribution, but is not included with OpenWindows 3.0 or
  earlier.  BB Stock Tool Release 2.1 has bundled "nls" directory at
  $STOCK_HOME/lib/X11/nls for Sun/SPARC version.  You can install it at
  /usr/lib/X11/nls, or setup an environment variable XNLSPATH pointing
  to $STOCK_HOME/lib/X11/nls.
  
o If you get error message "Unknown keysym name: osfRight", etc.
  Try download XKeysymDB from ftp.portal.com.

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

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 Stock Tool can run properly.

If you experience other problem, please send e-mail to us at
ctor@shell.portal.com.  Please provide us with:

>> Operating System version (the output of "uname -a")
>> Window version: X11R4, X11R5, OpenWindows
>> Output of "ldd $STOCK_HOME/bin/bb". 

It will help us to identify your problem.

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 them from Falkor Technologies at US$1.00 per stock.
Each historic stock quote contains daily high, low, closing and volume
for about two years.  Please use order form to order additional
historic quotes.

Daily Quote
===========
Falkor Technologies provides FREE BB Daily Quote Service to trial
users and licensed users.  The quote is sent via e-mail at the end of
each trading day.

You can register to receive BB daily quote via our web site or e-mail.
Our web site is at http://www.portal.com/~ctor/bb.html.  To register
via e-mail, simply send an e-mail 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.  (Note: we do not carry
mutual fund quotes).

    $ 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 
Stock Tool or from command line.

1. In BB Stock Tool, use "Edit => Update Historic Data...".
2. From command line, enter "fmttic t950807.dat t950808.dat"

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
==================
Please get authorization code via our web page at:
http://www.portal.com/~ctor/bb.html
