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 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 ", 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