JSB ALPHABrowser v2.0.1 for UNIX Systems JSB Corporation README March 1997 Welcome to the JSB ALPHABrowser v2.0.1. Please read this file as it contains information not included in the Help system. For easier reading, print the contents and keep the pages for reference. Topics in this file include the following: ------------------------------------------ SECTION 1 - INTRODUCTION SECTION 2 - CONFIGURING THE ALPHABROWSER SECTION 3 - RUNNING THE ALPHABROWSER SECTION 4 - ALPHABROWSER TROUBLESHOOTING SECTION 5 - TECHNICAL TIPS SECTION 6 - ALPHABROWSER LICENSE UPGRADE PROCEDURE SECTION 7 - NEW AT THIS RELEASE SECTION 8 - KNOWN PROBLEMS SECTION 9 - COPYRIGHTS SECTION 1 - INTRODUCTION If you have purchased the ALPHABrowser, a Serial Number or Numbers, along with the corresponding Activation Key(s) will have been supplied with the product. You are restricted by the License to only install the ALPHABrowser software on one remote system for each License you have purchased. If you are evaluating the software, you may install on as many remote systems as you wish. The evaluation period will expire 30 days after installation. JSB is committed to enhancing the ALPHABrowser. You may like to access JSB's Web or FTP sites periodically to download later versions of the ALPHABrowser, located at: www.jsb.com ftp.jsb.com/pub/ab SECTION 2 - CONFIGURING THE ALPHABROWSER The ALPHABrowser has 2 ASCII text configuration files associated with it, "color.cfg" and "alphabrw.cfg," located in the default browser sub-directory e.g. "/usr/jsbwww/browser". "alphabrw.cfg" determines the printer, file downloading mechanism and the default browser start-up file. "color.cfg" determines the colors to be used by the terminal (if your terminal supports color). SECTION 3 - RUNNING THE ALPHABROWSER To run the ALPHABrowser, type: alphabrowser Press "m" when the ALPHABrowser completes loading and select "Open Location" from the menu. Enter the URL for the site that you want to access in the form "http://remote_system_name:port/filename" as shown in the following examples. http://www.jsb.com http://www.jsb.com/welcome.html http://www.jsb.com:80/welcome.html You must include the "http://" portion of the URL. SECTION 4 - ALPHABROWSER TROUBLESHOOTING 1. The ALPHABrowser will not start. The following message will be displayed: THERE IS NO TERMINAL DEFINITION ... Possible reasons: a. The environment variable $TERM has not been set up. b. You do not have read permissions for "/usr/jsbwww/browser/window/$TERM". c. Your terminal is not supported, i.e. there is no corresponding file in "/usr/jsbwww/browser/window." Currently supported terminals are Wyse 60, Wyse 370, DEC VT100, VT220, VT241, VT320, VT420, IBM 3151, SCO ANSI color console, and terminals that emulate the preceding. d. The environment variable $WWWDIR has not been set up. (Only applies if the browser directory for the ALPHABrowser is not installed in the default of "/usr/jsbwww"). Try: a. Set $TERM b. Check file permissions c. Use a different terminal emulation d. Set $WWWDIR 2. Keystrokes being misinterpreted over slow connections Problems may be experienced over slow network or modem connections with the ALPHABrowser misinterpreting arrow keys etc. in the menus. This problem can be remedied by increasing the number of times the ALPHABrowser tries to read characters from the terminal before giving up. An environment variable W_TM can be defined before running the ALPHA- Browser which will increase the number of read attempts. A typical value of 10 works well with slow 2400 bps modems. The variable should be set using the following commands; Bourne and Korn shell C shell --------------------- ------- W_TM=10; export W_TM setenv W_TM 10 SECTION 5 - TECHNICAL TIPS SECTION 6 - UPGRADING ALPHABROWSER LICENSES To upgrade the ALPHABrowser license, change to the directory where the ALPHABrowser is installed (normally "/usr/jsbwww"). e.g. cd /usr/jsbwww Run the license upgrade script by typing: ./jsb.license Enter the new Serial Number and the corresponding Activation Key when prompted. SECTION 7 - NEW AT THIS RELEASE 1. Documents at several web sites include control-Z as a file terminator. On Wyse 60 terminals, this character blanks the screen completely. This release has a workaround for the problem. SECTION 8 - KNOWN PROBLEMS 1. The Wyse 60 cursor keys do not send standard ANSI sequences by default. ALPHABrowser will reprogram these keys when it starts and return them to the default settings when it exits. If you invoke a shell session from within ALPHABrowser, the cursor keys will still send the new sequences. This could lead to improper operation of applications run this way. 2. The Wyse 55 terminal does not have a native personality. If you specify wy55 or wyse55 as your terminal type (TERM environment variable) ALPHABrowser will assume you are using the Wyse 60 personality. If you use one of the other personalities supported by ALPHABrowser, you must set the TERM environment variable accordingly. SECTION 9 - COPYRIGHTS JSB ALPHABrowser ================ University of Kansas copyright This product includes computer software created and made available by The University of Kansas. THIS SOFTWARE IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS. COPYRIGHT HOLDERS WILL BEAR NO LIABILITY FOR ANY USE OF THIS SOFTWARE OR DOCUMENTATION. --------------------------------------------------------------------