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