FILE: web-inst-alpha.html                              Mar 27, 1997


              WEB INSTALLATION ON VAX/VMS (Alpha AXP)

0)  CONTENTS OF THIS DOCUMENT:
    ==========================

    1)  LOADING THE TAPE
    2)  INSTALLATION OF EXECUTABLES
    3)  OTHER INSTALLATION-DEPENDENT FEATURES
    4)  TESTING WEB 
    5)  BUGS
 

1)  LOADING WEB TAPE

    Code is distributed on TK50 tapes in DEC BACKUP format.
    To load the tape use the following commands but substitute your
    TK50 (or TK70) tape drive's logical name for msa0: and your 
    desired WEB source code location for web_dir:

    $ALLOC msa0:
    $SET DEF [web_dir]
    $BACKUP /LOG msa0:WEB.BCK [...]*.*
       
    The web-directory web-dir will contain all WEB files. The source 
    code has  been compiled and placed in the WEB.OLB object library.  
    The executable binary file is called WEB.EXE.

2)  INSTALLATION OF WEB

    A) Using Precompiled and Linked Executables.
       The WEB directory web_dir contains an executable binary file 
       WEBA.EXE. If you are running VMS 6.0+ you should be able to use 
       the WEB executable provided in that directory.  Use the 
       following command to run WEB from a terminal window:

       $RUN [web_dir]WEBA
               .ENTER DATA CODE: DAT

       If the executable files do not run on your computer proceed 
       to step B).  
     
    B) Linking the Executable.
       If WEB does not run, there is probably an incompatibility in the
       use of shared libraries or the operating system version.  You
       may have to link WEB on your machine.    

       LINKWEB.COM contains sample code for linking WEB.  Edit the
       linking options file WEBA.OPT for any necessary local linking
       modifications.  Then use the following commands to link WEB
       and create new executable files:

       $@[web_dir]LINKWEBA

       If the link fails or the new executable file does not run 
       proceed to step C). 

 
    C) Compiling and Linking the Executable.
       If WEB does not link properly then you may not have sharable
       images for your DEC-WINDOWS or you can not use the object 
       library due to incompatible operating system versions.  
       You may have to create a new WEB system starting from the source 
       code files.  WEBAGEN.COM contains commands for complete 
       WEB generation, starting from the source code files. This 
       command file directs all the steps (compile, build library, 
       link) to create the executable files of the SPIDER  system.  
       Use the  following commands (see note 3B below first):

       $SET DEF [web_dir]
       $@WEBAGEN.COM

       If the compilation fails or the new executable does not 
       run, and you are on a DEC computer contact us at the address 
       below. 


    D) Use of DEC's Module Management System
       If you have DEC's Module Management System on your computer, 
       web_dir contains a makefile (DESCRIP.MMS) which compiles 
       the source code, places the object code in a library, links the 
       object code, and creates an executable binary file.  In this case 
       use the following commands instead of those given in C) above:

       $SET DEF [web_dir]
       $REN  WEBA.OLB WEBA_ORIG.OLB
       $MMS
 

3)  OTHER INSTALLATION TASKS

    A) Logical and Symbol Assignments for Users.
       Inside WEB, directory and disk names are specified by logical
       names which you define in your WEB users login files.  These 
       names are necessary to access color tables and WEB manuals.

       $ASSIGN  /JOB/GROUP/PROCESS  [web_dir] RGB_LOC
       $ASSIGN  /JOB/GROUP/PROCESS  [web_dir] WEBMAN_DIR

       You also may wish to set up a symbol definition in the users
       login file so that users can start WEB from any location easily.

       $WEB == "RUN [web_dir]WEBA.EXE"

    B) Logical Assignments for Programmers.
       To compile programs, you need certain logical variables defined 
       for locations of source code.  Add the following definition to 
       the LOGIN.COM files of any user who will do SPIDER related
       program compilation.  

       $ASSIGN [web_dir] DSWC


    C) DEC-Windows Colors.
       If your image display window does not have a black background or
       the colors are not working properly, copy the  two files with 
       names starting  with the first four letters DECW into your 
       login directory and rename the files to add a $ after the DECW. 
       This will ensure correct startup assignments into colormaps.  If  
       you continue to have colormap problems contact us.  Some sites 
       have intermittant problems with colormap assignments depending
       on other concurrently executing DEC-WINDOWS programs.

    D) WEB is written for an 8-bit false-color visual.  If your X-server
       is set for 24 bit true-color exclusively, you may have to 
       alter the setting to allow use of an 8 bit false-color visual.

4)  TESTING WEB

    To test WEB use the following commands:
 
    $SET DEF [web_dir]
    $RUN WEB
         .ENTER DATA CODE: DAT

          USE MOUSE TO SELECT MENU ITEMS

    Further info is given in web.man.


5)  BUGS, SUGGESTIONS:

    Please send any bug reports to:

       ArDean Leith
       phone: 518-474-7049 or 518-486-5604
       fax:   518-474-7992
       email: leith@wadsworth.org