0. Mosaic 2.0 for VMS (release 14) This file describes a port of Mosaic 2.0 to VMS. This version has been generated and tested on VAXes running OpenVMS 6.1 with Mul- tiNet version 3.2, on VAXes with VMS 5.5-2 and UCX 2.0E, and on AXP machines using OpenVMS 2.0 and UCX 3.0 or MultiNet 3.2. Sup- port for the TWG Pathway TCP/IP product is also included. This release completely replaces my earlier Mosaic 2.0 port for VMS. I have made many fixes, so the change list is very long. Only a few important changes are mentioned at the end. The tar file Mosaic-2.0-14.VMS.tar.Z contains the full sources from NCSA with my modifications. My changes are ifdef-ed with my signature (BSN) in a comment. I have only implemented the minimum so there is no DTM support. If you have any problems with installing or running this program, feel welcome to write a note to me. I have had great help from communication with Martin Gelbaum at Lawrence Berkeley Lab, and with Mark Donszelmann at Delphi, CERN. For help with this particular version I would like to mention Martin P.J. Zinser at GSI, Darmstadt, and Stellan Lagerstrom at the Royal Institute of Technology, Stockholm. I have also had a lot of positive feedback after I released the previous versions of my Mosaic 2.0 ports. I hope this continues, it is very helpful and 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 an uncompress program and a VMS version of tar for this. I am using programs from ftp.spc.edu, directory [.MACRO32.SAVESETS] There is LZW and GZIP-1-2-4 for uncompressing, and a VMS version of tar, VMSTAR. All are stored as ZIP savesets. - The sources have many defaults built in. Mosaic is using aux- illiary programs for viewing etc. The default definitions for these programs are in [.libwww2]HTInit.c There are many other resources defined in [.src]xresources.h Three of these can be defined in the scripts you will use when building, either MAKE_MOSAIC.COM or [.src]descrip.mms Make sure you do not remove any of the quotes, all of them are necessary:-( 1) You may want to define your own default home page for the homeDocument resource. Change HOME 2) Choose a print command appropriate to your site. Change PRINT_COMMAND 3) 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. Change MAIL_PREFIX Other defaults that you could consider changing are: 1) Instead of DECterm you may want to use xterm or what you have. See [.src]xresources.h 2) I have chosen gunzip for all uncompressing, you may want to change that. Also in [.src]xresources.h 3) 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" 4) You may want to put the file documents.menu somewhere else than in DECW$System_Defaults See [.src]xresources.h 5) You may like to start DECsound differently than I did See [.libwww2]HTInit.c - There could be some font problems. Most DEC X-servers still miss the Lucida fonts. Also, often the 17pt fonts used by Mosaic are missing. The fonts used are listed in xresources.h I have inserted ifdefs so that normally 17pt fonts are replaced by 18pt fonts, and Lucida by fixed. Check your server if this is really 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 use TWG PathWay TCP/IP product, read the relevant files in the [.TWG] subdirectory. 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, but the most important one is [.src]descrip.mms which has some defaults described above. Then build by $ MMS/Ignore=Warning/Macro=... executed in the top directory. If you use the command file, make any changes you might need (check the setting of HOME, PRINT_COMMAND and MAIL_PREFIX at the top) and then execute it: $ @Make_Mosaic In either case this should build everything. You should not get any errors or warnings. If you do I would like to know about it. However, if you are using UCX and get a list of unsatisfied externals, you can probably blame me. When linking to UCX on VAXes the UCX_VAX.OPT file is used. This includes UCX by referring to the object library SYS$LIBRARY:UCX$IPC.OLB/LIB On AXPs the corresponding option file UCX_AXP.OPT uses a shareable SYS$LIBRARY:UCX$IPC_SHR.EXE/SHARE If there are cases where this does not work I would very much like to hear about them. 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 DECW$USER_DEFAULTS (normally SYS$Login:) with name 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.wku.edu in directory [.macro32.savesets], or at mirrors at many sites. Some other locations are: xv: ftp.cis.upenn.edu in the pub/xv directory. ghostscript and ghostview: prep.ai.mit.edu in the /pub/gnu directory (for VAX. To the best of my knowledge these programs are not ported to AXP yet). mpeg_play: http://www.geom.umn.edu/docs/mpeg_play/mpeg_play.html or for ftp, ftp.geom.umn.edu file /priv/daeron/src/mpeg_play-src.tar.Z and also at ftp.wku.edu 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. If Mosaic crashes, please send me a mail describing how you used Mosaic just before the crash. What pages did you (try to) look at? Did you invoke Mosaic as a subprocess, as a detached process, or as a regular process? Did you have any problems compiling and linking? Give any information you may find relevant too. Enjoy! ==================================================================== Some changes after the first release up to fix 6: 1. Support for TWG's PathWay TCP/IP software from TWG 2. Message and information windows are popped up beside the Mosaic window. Message pop-ups are invoked when file operations fail. 3. Installation scripts rewritten so that defaults can be defined there instead of in the code. 4. VAXC and DECC fputs() are limited to output 65535 characters. This often meant that files saved from Mosaic were truncated. fputs() is now replaced by write() everywhere. 5. A bug was corrected in the VMS mail interface. 6. The HTFTP.c routine was changed so that also TWG ftp servers can be dealt with. Unlike MultiNet, TWG servers are sensitive to the setting of binary/ASCII mode. A toggle for this was introduced in the options pull-down menu. 7. The telnet window now stays up after logout until Return is hit so that possible logout information can be seen. 8. Mosaic can be controlled remotely. If you start the program a -mbx switch it will act on commands sent to a mailbox named MOSAIC_username The logical name for the mailbox can also be set with an argument following a -mbx_name switch. Finally, the mailbox name can be entered in your group name table with a -mbx_grp switch, provided you have GRPNAM priv. The commands are defined and acted upon in the routine mo_process_external_directive in [.src]gui.c The possible com- mands are: goto|URL newwin pagedown pageup scrolldown scrollup flushimagecache backnode forwardnode reloaddocument reloadimages refresh The goto command must be followed by a vertical bar and then the URL of the page to display. 9. Bugfixes, e.g. wrt some directory operations. 10. Revised building procedures. Several more checks were added and support for Motif 1.2 built in. 11. The HTFTP.c routine was changed again to support Hunter Goatley's MadGoat ftp server as well as UCX servers. UCX and TWG servers must be told if ascii or binary mode should be used. Therefore code was hacked up to try to determine what kind of server Mosaic is talking to. Also, a URL starting with ftp://username:password@node can now be used for ftp-ing also to non-anonymous accounts. You must be extremely careful if using this feature!! The password is displayed on your screen since it is part of the URL. It is also recorded in your MOSAIC.GLOBAL-HISTORY file! 12. Stellan Lagerstrom, stellanl@e.kth.se, provided fixes to cure the double image problem seen on 4-plane displays. Thanks Stellan! 13. Mark Donszelmann (dusn@vxdeop.cern.ch) submitted code for a few additional remote control commands (see 8. above). The new commands are: iconify deiconify raise move resize 14. I added a first version of a mailto widget. That is, this Mosaic can now handle URLs of the type mailto:user@node.domain You will get a window where you can enter a Subject and a message which is then mailed if you so wish. ==================================================================== Bjorn S. Nilsson, ALEPH, CERN 25-Nov-1993, 29-Mar-1994 and 16-Jul-1994. Email addresses: Niels Bohr Institute, Copenhagen: nilsson@nbi.dk (best choice) CERN: nilsson@alws.cern.ch http://alephinfo.cern.ch/@ALWHO?nilsson