0. Mosaic 2.0 for VMS This file describes a port of Mosaic 2.0 to VMS. This version has been generated and tested on VAXes running VMS T6.1 with MultiNet version 3.2, on VAXes with VMS 5.5-2 and UCX 1.3 or 2.0D, and on AXP machines using OpenVMS 1.5 and UCX 3.0. Patches added later (see #6 at the end of this file) introduce support for AXPs with MultiNet. The same patches also include some significant improve- ment for the UCX version. The tar file Mosaic-2.0.VMS.tar.Z contains the full sources from NCSA plus my modifications. When sources are changed, I have re- named the original to a filename with a "_orig" appended to the file type. My changes are ifdef-ed with my signature (BSN) in a comment. I have only implemented the minimum, there is no DTM support. If you have any problems with installing or running this program, feel welcome to write a note to me. The program has been tested for a couple of days, but with a system this complex there simply must be some remaining bugs which I am responsible for. When ne- sessary I will add patches and update this README file. I have had great help from communication with Martin Gelbaum at Lawrence Berkeley Lab, and with Mark Donszelmann at Delphi, CERN. Also, after I did the version 1.2 port I have been flooded with mail from lots of nice people, and by now, I hope, happy users. I hope this continues, it is very inspiring. 1. Before installation. - Make sure that you have DECWindows Motif and the Miscellaneous Utilities optional library. The latter can be checked with a Show Logical Xmu which should show something like "XMU" = "SYS$SYSROOT:[DECW$INCLUDE.XMU]" If you do not have this software, stop here. - First unpack the tar file. You need a VMS version of tar for this. Most VMS files servers have it. - The sources have many defaults built in. Mosaic is using many programs for viewing etc. The defaults for these programs are in [.libwww2]HTInit.c There are many other resources defined in [.src]xresources.h You should especially pay attention to a) You may want to define your own default home page for the homeDocument resource. b) Choose a print command appropriate to your site. c) Instead of DECterm you may want to use xterm or what you have. d) I have chosen gunzip for all uncompressing, you may want to change that. e) If you have not installed ghostview and ghostscript you can use DECWindows VIEW as PostScript Previewer. You must then change [.libwww2]HTInit.c appr. line 180 where application/postscript is defined to gv. Change "gv %s" to "View/Interface=DECWindows/Format=PS %s" f) You may want to put the file documents.menu somewhere else than in DECW$System_Defaults g) Finally you should choose an appropriate Mail suffix. At CERN we use a mailer dxmint via DECnet and prefixVMSMail is set to "dxmint::". If you have PMDF or MX, this suffix should be "IN%" or "MX%" Mosaic puts in all the necessary quotes to satisfy VMS MAIL. This also goes into the Mosaic.DAT file. - There could be some font problems. Most DEC X-servers miss the Lucida fonts. Also, often the 17pt fonts used by Mosaic are missing. The fonts used are listed in xresources.h I have in- serted ifdefs so that normally 17pt fonts are replaced by 18pt fonts, and Lucida by fixed. Check your server if this really is necessary. You can use xlsfonts for this. There is a version in SYS$COMMON:[SYSHLP.EXAMPLES.DECW.UTILS] if your system is correctly installed. - If you link to UCX version 1 or 2 you should change the option file [.src]UCX.Opt SYS$LIBRARY:UCX$IPC_SHR.EXE/SHARE -> SYS$LIBRARY:UCX$IPC.OLB/LIB since the shareable library does not contain all routines 2. Installation Decide whether you want to build with MMS or just use the command file make_mosaic.com In the first case, check the various DESCRIP.MMS files. There is one in each directory. Then build by $ MMS/MACRO=... executed in the top directory. If you use the command file, make any changes you might need and then exucute it: $ @Make_Mosaic In either case this should build everything. 3. Post-installation. Mosaic, like most programs using X, needs an application resource file. There is a colour and a mono version in Mosaic.Dat_Color and Mosaic.Dat_Mono. Check these, and move the appropriate one to your "applications defaults" directory with name SYS$COMMON:[DECW$DEFAULTS.USER]Mosaic.Dat However, you should make both files publicly available. Users, who want to customize more, should copy the appropriate file to SYS$Login:Mosaic.Dat and modify it further there. Mosaic is also using a file named documents.menu to configure one of the pull-down menus. Check this file, and then copy it to the location given in [.src]xresources.h 4. Post post-installation. You may find that you miss some auxilliary programs for uncompressing, viewing etc. You should be able to find most of what you need on Hunter Goatley's ftpserver at ftp.spc.edu, or mirrors at many sites. You will also find lots of information by reading the Mosaic Resources page (in the Documents menu). And finally, do notify me if/when you find problems. Good luck! ==================================================================== Bjorn S. Nilsson, ALEPH, CERN 25-Nov-1993 nilsson@alws.cern.ch http://alephinfo.cern.ch/@ALWHO?nilsson ==================================================================== Update on 1-Dec-1993. Three fixes have been added. 1. A change so that the telnet userinformation window pops up before the telnet connection is done. 2. A modified HTFTP.c that works with ftp-servers running VMS. Only MultiNet has been tested, but I believe this code works with UCX too. This fix is available as a VMS diff file and as a full HTFTP.c file named HTFTP.c.Allow-VMS.Z 3. Minute changes to xresources.h replacing the word xmosaic with Mosaic. ==================================================================== Update on 13-Dec-1993. Three fixes have been added. 4. If you want a nicer icon pixmap than the original, apply fix 4. 5. Several people have had problems to use DECsound. A better choice for the default sound method than my original is described in this fix. The role of the two MIME files (MAILCAP and MIME.TYPES) is explained briefly. 6. Several changes to the TCP/IP interface to remove bugs due to in- consistent return codes from UCX. This provides a significant speed- up, removing a problem with duplicate access to the WWW-server. UCX versions pre 3.0 could not interact correctly with servers requiring authorization. This also works now. Finally, this set of patches also contains changes so that the code will compile and work on AXP machines with MultiNet. ==================================================================== Update on 14-Dec-1993. 7. Mike O'Malley has contributed changes so that Mosaic can also be built using the CMU-OpenVMS/IP TCP/IP package. The line numbers may be approximate if you have applied any of the previous patches. NOTE: These patches should _not_ be applied unless you use CMU-OpenVMS/IP. UCX and MultiNet users must ignore them. ==================================================================== Update on 18-Dec-1993. My 6th fix was doing several changes to the basic communications routines. It was therefore rather lengthy, and needed a lot of manual work to be applied. I should have thought of distributing the full, changed files together with the patches. The files changed by fix 6 are now archived in Mosaic-2.0.VMS.Fix-6.tar.Z