| Previous | Contents | Index |
V1.2--5
The Spyglass Enhanced Mosaic browser is no longer provided with the DECwindows Motif software and is no longer supported. If your system has a previous version of DECwindows Motif, the DECwindows Motif Version 1.2-5 for OpenVMS installation procedure removes this software. Compaq suggests that you download the Netscape Navigator browser from the DIGITAL OpenVMS Internet Solutions web page at the following location:
http://www.openvms.digital.com/openvms/products/ips |
Fill out the customer registration form and then follow the instructions for downloading the software.
On OpenVMS 7.2 systems, the Netscape Navigator is an option when installing the OpenVMS software. The Netscape Navigator is not supported on VMS 5.5--2 systems. On these systems, you can use the NCSA Mosaic Browser (see next section). |
V1.2--3
DECwindows Motif for OpenVMS provides the National Center for Supercomputing Applications (NCSA) Mosaic Version 2.4 browser to let you navigate and access information on the Internet.
The NCSA Mosaic browser is provided as sample, "as is" software to introduce you to the Internet and help you get started using a World Wide Web viewer. Because the NCSA Mosaic browser that ships with this release is only a sample implementation, we have placed Mosaic with the other sample software in the DECW$UTILS directory. We plan to replace this sample NCSA Mosaic browser implementation in a future release.
The Mosaic browser enables OpenVMS users to search, retrieve, display, store, and forward data using the Internet. Mosaic functions in conjunction with the World Wide Web environment, which is a collection of information servers.
Note that the graphical user interface for Mosaic is not compliant with the Motif style guide; therefore, the Mosaic browser does not look the same as the DECwindows Motif out-of-the-box (OOTB) applications.
The following information about Mosaic is included in this section:
V1.2--3
The Mosaic browser, which is located in the DECW$UTILS directory, is installed as part of the product installation for the DECwindows Motif for OpenVMS product.
To access the verb and start Mosaic, select Menus... from the Options Menu in FileView. Mosaic is listed in the Item Names list. Add the verb Mosaic to a menu, such as the Applications Menu, so that you can invoke Mosaic and display the DECwindows Motif for OpenVMS home page. Refer to Using DECwindows Motif for OpenVMS for information about adding verbs to menus.
You can display the sample DECwindows Motif for OpenVMS home page without a TCP/IP connection to the network. However, to access information contained in the topics in the Help menu requires that TCP/IP Services for OpenVMS be installed. |
V1.2--3
A home page lets you make information about yourself, your company, your products, and so on available on the Internet. Click on the On HTML... topic in the Help menu for information about using HTML (Hypertext Markup Language) to create a home page. HTML uses markup tags to tell Mosaic how to format text. A Beginner's Guide to HTML is displayed, which provides information about markup tags, examples, formatting, creating links, troubleshooting, and so on. Note that you can access topics in the Help menu only if your system is connected to the TCP/IP network using TCP/IP Services for OpenVMS.
As an example of an HTML source, see the DECwindows Motif sample home
page. Click on View Source... from the File menu to see the
HTML source.
1.15.3 Configuring Mosaic to Process Multimedia Files
V1.2--4
The Mosaic browser that is included with DECwindows Motif for OpenVMS provides support for recognizing and processing the following types of files:
If Mosaic encounters a hyperlink (or an anchor) to any of these file types, it attempts to start an external program to display the image or to play the sound. If Mosaic cannot locate an appropriate external viewer, it prompts the user to enter a file name where the data file can be stored in case the data is needed outside of Mosaic.
To determine what external viewer will display the image or play the sound, Mosaic does the following:
For example, GIF files are mapped to the xv viewer. The xv viewer is shareware software that is not provided with DECwindows Motif. However, the xv viewer is available at the following Uniform Resource Locator (URL) address:
http://gatekeeper.dec.com/pub/net/infosys/pw/pw-fetch.html
|
The xv mapping is defined in the file DECW$UTILS:XMOSAIC-SETUP.COM, a self-documented command procedure, as follows:
$ XV :== $DECW$EXAMPLES:PICT.EXE
|
The executable PICT.EXE is used to display the GIF file. Note that PICT.EXE cannot be used to display a JPEG file.
Other mappings include the following:
| Image Type | Display/Sound Logical Name |
|---|---|
| audio/* | -> showaudio |
| image/xwd | -> xwud |
| image/x-xwd | -> xwud |
| image/x-xwindowdump | -> xwud |
| image/* | -> xv |
| application/postscript | -> ghostview |
Mappings in the previous list that are followed by an asterisk (*) are available in some versions of Mosaic (for example, Version 2.4) that contain native HDF/netCDF support.
Additional examples of external view setup in the file DECW$UTILS:XMOSAIC-SETUP.COM can include the following definitions:
$ APLAY :== mcr decsound -volume 70 -speaker -play $ SHOWAUDIO :== mcr decsound -volume 70 -speaker -play $ GHOSTVIEW :== view/format=ps/interface=decwindows $ XWUD :== $decw$utils:xwud.exe |
V1.2--4
You can customize the Mosaic browser by setting any of the NCSA Mosaic X resources in the file DECW$USER_DEFAULTS:MOSAIC.DAT.
The class name for Mosaic for X is Mosaic. The information that follows shows the names and descriptions of the X resources. Note that class and resource names are the same except that the first character in the resource name is capitalized.
The following resources are listed:
Table 1-2 lists the functional resources and descriptions.
| Resource | Description |
|---|---|
| annotationsOnTop: Boolean | Indicates whether inlined document annotation hyperlinks are prepended to the document (if true) or postpended (if false). (Default is false). |
| autoPlaceWindows: Boolean | If set to false, the new Document View windows are not automatically positioned by the program itself; your Window Manager determines the placement. (Default is true.) |
| catchPriorAndNext: Boolean |
Controls whether using the keys Prior and Next (Page Up and Page Down
on most keyboards) are explicitly caught in the Document View window
and passed to the vertical scrollbar, or whether the normal Motif
scrolled window mechanism is relied upon to automatically take this
action. (Default is false.)
If the Page Up and Page Down key sequences are not functioning appropriately for your environment, set this resource to true. (Refer to the information about hot keys.) |
| confirmDeleteAnnotation: Boolean | Confirms deleted annotations through a confirmation dialog box. (Default is true.) |
| confirmExit: Boolean | Determines whether the NCSA Mosaic browser pops up a dialog box to confirm exiting from the program when the Exit Program menu option is selected. (Default is true.) |
| defaultAuthorName: string | Identifies your full name (for example, John Q. Public). Your full name is normally stored in the system password file, and Mosaic extracts the name from that file if this resource is NULL; otherwise, the value of this resource is used. (Default is NULL.) |
| defaultHeight: integer | Specifies the default height in pixels for a Document View window. (Default is 680.) |
| defaultHotlistFile: string | Specifies a file name to store the default hotlist (or a list of bookmarks). (Default is ".mosaic-hotlist-default". The value of the environment variable $HOME is prepended to this string.) |
| defaultWidth: integer | Specifies the default width in pixels for a Document View window. (Default is 620.) |
| delayImageLoads: Boolean |
Selects delayed image loading, which is for users with slow network
connections. If set to true, Mosaic substitutes a small icon for
inlined-images and an arrow icon for inlined-images that also act as
hyperlinks. Clicking on an icon tells Mosaic to load that
inlined-image; clicking on the arrow is equivalent to following the
associated hyperlink.
Selecting Load Images in Current from the Mosaic Options menu loads and displays all the inlined-images in the current document. Delayed image loading can also be selected with the -dil command-line flag or on a per-window basis from the Options menu in Mosaic. (Default is false.) |
| displayURLsNotTitles: Boolean | Displays URLs wherever document titles are usually displayed, if set to true. (Default is false.) |
| DocsDirectory: string | Overrides the location of the help documents. (Default is NULL.) |
| documentsMenuSpecfile: string | Specifies the name of the file that holds an optional "Documents Menu Specfile" to allow sites to add their own Documents menu to the Mosaic menu bar. For more information, see the documentation about creating a configurable Documents menu. (Default is "/usr/local/lib/mosaic/documents.menu".) |
| fancySelections: Boolean | Cuts and pastes from the Document View window with fancy selections enabled in the HTML widget, which results in underlined headers, bulleted lists, and so on, if set to true. Uses normal selection behavior if set to false. Note that selections can be for each window at any time. (Default is false.) |
| fullHostname: string | Allows explicit setting of the fully qualified host name for systems that fail on a call to gethostbyname(). Use the fullHostname resource only if necessary, in conjunction with gethostbynameIsEvil. |
| gethostbynameIsEvil: Boolean | Set to true if you are running your system on a Sun set up so that when the system attempts to find its own full host name through gethostbyname(), the system coredumps. (Default is false.) |
| globalExtensionMap: string | Set to the location of the system-wide extension map config file of your choice. (Default is "/usr/local/lib/mosaic/mime.types".) |
| globalHistoryFile: string | Specifies the name of the file to store the global history of all documents accessed from session to session. (Default is .mosaic-global-history. The value of the environment variable $HOME will be prepended to this string.) |
| globalTypeMap: string | Specifies the location of the system-wide mailcap (type map config) file of your choice. (Default is "/usr/local/lib/mosaic/mailcap".) |
| gunzipCommand: string | Specifies the command to uncompress gzip files (that is, files with an extension of .z.) You can obtain gunzip from prep.ai.mit.edu in /pub/gnu. (Default is gunzip -n -f, which requires the 1.2.4 version of gzip.) |
| hdfMaxImageDimension: integer | Specifies the maximum height and/or width of an HDF inlined image in pixels. (Default is 400.) |
| hdfMaxDisplayedDatasets: integer | Specifies the maximum number of displayed data sets while browsing HDF files. If more than the maximum number exist in an HDF file, Mosaic displays the HDF file in "brief mode". (Default is 15.) |
| hdfMaxDisplayedAttributes: integer | Specifies the maximum number of displayed attributes while browsing HDF files. If more than the maximum number exist in an HDF file, Mosaic displays the HDF file in "brief mode." (Default is 10.) |
| hdfPowerUser: Boolean | Set to true if most of the supporting text in an HDF file will be removed. (Default is false.) |
| homeDocument: string | Specifies the document to access at program startup. See the information about on specifying your home document. (Default is http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/ NCSAMosaicHome.html) |
| imageCacheSize: integer | Specifies the size of the inlined-image cache in kilobytes. The -ics command-line flag can also be used. All the images in a given document are (temporarily) cached while on that page, regardless of the imageCacheSize value. Cache flushes the least recently viewed. (Default is 2048.) |
| initialWindowIconic: Boolean | Set to true if the first Document View window opened (when the program starts) will be iconified. (Default is false.) |
| maxWaisResponses: integer | Controls the maximum number of matches Mosaic accesses from a WAIS server. (Default is 200.) |
| personalAnnotationDirectory: string | Specifies the name of the directory in which to store personal annotations (as well as the log file of all personal annotations currently in existence). If the named directory does not exist, it is created. However, intermediate directories, if any are named, are not created. (Default is .mosaic-personal-annotations. The value of the environment variable $HOME will be prepended to this string.) |
| personalExtensionMap: string | Specifies the location of the personal extension map configuration file of your choice. The value of the environment variable HOME is prepended. (Default is .mime.types) |
| personalTypeMap: string | Specifies the location of the personal mailcap file of your choice. The value of the environment variable HOME is prepended. (Default is .mailcap) |
| printCommand: string | Specifies the name of the default command for the Print menu option. This command accepts a single argument: the name of the file to print. Note that this location can be changed at any time through the Print option's dialog box. (Default is lpr) |
| recordCommandLocation: string | Specifies the location (full path name) of the command used to record audio annotations (on Sun, SGI, and HP platforms). If the named command does not exist when Mosaic is started, audio annotations are disabled (the menu entry becomes insensitive). (Default is "/usr/sbin/recordaiff" on SGI; "/usr/demo/SOUND/record" on Sun; "/usr/audio/bin/srecorder" on HP.) |
| recordCommand: string | Specifies the command used to record audio annotations; this is the full command, using the command named in recordCommandLocation as the first word. (Default is "recordaiff -n 1 -s 8 -r 8000" on SGI; "record" on Sun; "srecorder -au" on HP. The named command accepts a single additional argument: the file name of the new audio file. The command also correctly terminates recording when a SIGINT is sent.) |
| reloadReloadsImages: Boolean | Clears out the Reload option cached image data for the current document before reloading the document if set to true; thus causing the images to also be reloaded. This is useful for HTML authors who are using Mosaic to view their work. (Default is false.) |
| sendmailCommand: string | Specifies a pointer to the sendmail binary. It assumes that this program accepts command-line arguments that specify addresses to which messages should be mailed and accepts other headers and message text from stdin. (Default is "/usr/lib/sendmail".) |
| simpleInterface: Boolean | Allows the Mosaic menu bar and bottom button configuration to be minimized considerably. (Default is false). |
| tmpDirectory: string | Specifies the name of the directory in which to store temporary files generated by Mosaic. This directory should contain at least 10 or 20 megabytes, in case you to pull down a very large data file. Setting this resource is equivalent to using the command-line flag, -tmpdir, or setting the environment variable TMPDIR. |
| trackFullURLs: Boolean | Enables prototypical smart display of "where you're going" during mouse tracking, including format definition, if set to false. (Default is true.) |
| trackPointerMotion: Boolean | Sets the mouse pointer so that it will not be tracked so that URLs are visible on the lower status line, if set to false. (Default is true.) |
| trackVisitedAnchors: Boolean | Displays visited anchors (that is, anchors that point to documents that have previously been viewed) with a different style than anchors that are not yet visited, if set to true. (On slow systems, changing this resource to false may substantially improve the performance of Mosaic.) (Default is true.) |
| tweakGopherTypes: Boolean | Mosaic interprets Gopher documents strictly by the Gopher typing system, if set to false. When set to true, Mosaic uses its own mechanism to determine the file types of Gopher documents. (Default is true.) |
| twirlIncrement: integer | Indicates the minimum number of bytes that are are transferred between updates of the twirling transfer icon for normal (FTP, Gopher, HTTP) transfers. (Default is 4096.) |
| twirlingTransferIcon: Boolean | Set to false to turn off the twirling NCSA logo during document transfers. Clicking the icon still interrupts a transfer. (Default is true.) |
| uncompressCommand: string | Specifies the command to uncompress compressed files (that is, files with an extension of .Z). (Default is uncompress). |
| useDefaultExtensionMap: Boolean | Set to false to keep any default file-extension-to-MIME-type mappings from Mosaic. Keeping this resource setting to true and overriding the default as necessary is strongly recommended. (Default is true.) |
| useDefaultTypeMap: Boolean | Set to false to keep any default MIME-type-to-external-viewer mappings from Mosaic. It is strongly recommended that you leave this resource set to true; override the setting as necessary. (Default is true.) |
| useGlobalHistory: Boolean | Automatically stores a global history of everywhere you visit, if set to true. (This history is used to shade anchors in different colors based on whether you visited the corresponding documents, if the resource trackVisitedAnchors is set to true.) (Default is true.) |
| xtermCommand: string | Specifies the name of the command used to start a terminal window for a telnet session. (Default is xterm on most platforms; the default is aixterm -v on IBM AIX 3.x systems.) |
Table 1-3 lists the visual resources that are associated with the HTML widget that is used in the Document View window. Specify these resources in the file DECW$USER_DEFAULTS:MOSAIC.DAT in the following format:
Mosaic*anchorColor: cyan |
| Resource | Description |
|---|---|
| anchorColor: color | Specifies the color to shade anchors whose corresponding documents have not previously been visited. (Default is blue3.) |
| visitedAnchorColor: color | Specifies the color to shade anchors whose corresponding documents have previously been visited. (Default is violetred4.) |
| activeAnchorFG: color | Specifies the color to shade anchors that are in the process of being activated. (Default is red.) |
| activeAnchorBG: color | Specifies the color to shade the background of the anchors that are in the process of being activated. (Default is grey80, which is the same color as the background in the browser.) |
| anchorUnderlines: integer | Specifies the number of lines to draw underneath the unvisited anchors (Valid values: 0, 1, 2, 3) (Default is 1.) |
| visitedAnchorUnderlines: integer | Specifies the number of lines to draw underneath the visited anchors. Valid values: 0, 1, 2, 3 (Default is 1.) |
| dashedAnchorUnderlines: Boolean | Sets drawn lines under the unvisited anchors to dashes, if set to true. (Default is false.) |
| dashedVisitedAnchorUnderlines: Boolean | Sets drawn lines under unvisited anchors to dashes, if set to true. (Default is false.) |
| colorsPerInlinedImage: integer | Specifies the number of unique colors to allocate for each inlined-image. (Note that this setting does not affect the images that are displayed externally to the NCSA Mosaic browser (for example, GIF images passed to an external viewer).) (Default is 50.) |
| percentVerticalSpace: integer | Specifies the height of the vertical space between paragraphs, headers and paragraphs, and so on, as expressed as a percentage of the normal line height. (Default is 90.) |
| reverseInlinedBitmapColors: Boolean | Specifies to reverse foreground and background colors in inlined XBM bitmaps, if set to true. (Default is false.) |
| verticalScrollOnRight: Boolean | Specifies that the Document View window places its scroll bar on the left side, if set to false. (Default is true.) |
Font resources, which are also associated with the HTML widget, can be changed dynamically from the Options menu. Table 1-4 lists the font resource names and descriptions.
| Resource | Description |
|---|---|
| font: font | Used in normal formatted text. (Default is "-adobe-times-medium-r-normal-*-17-*-*-*-*-*-iso8859-1".) |
| italicFont: font | Used in italic formatted text. (Default is "-adobe-times-medium-i-normal-*-17-*-*-*-*-*-iso8859-1".) |
| boldFont: font | Used in bold formatted text. (Default is "-adobe-times-bold-r-normal-*-17-*-*-*-*-*-iso8859-1".) |
| fixedFont: font | Used in fixed (typewriter style) formatted text. (Default is "-adobe-courier-medium-r-normal-*-17-*-*-*-*-*-iso8859-1".) |
| header1Font: font | Used in level 1 headers. (Default is "-adobe-times-bold-r-normal-*-24-*-*-*-*-*-iso8859-1".) |
| header2Font: font | Used in level 2 headers. (Default is "-adobe-times-bold-r-normal-*-18-*-*-*-*-*-iso8859-1".) |
| header3Font: font | Used in level 3 headers. (Default is "-adobe-times-bold-r-normal-*-17-*-*-*-*-*-iso8859-1".) |
| header4Font: font | Used in level 4 headers. (Default is "-adobe-times-bold-r-normal-*-14-*-*-*-*-*-iso8859-1".) |
| header5Font: font | Used in level 5 headers. (Default is "-adobe-times-bold-r-normal-*-12-*-*-*-*-*-iso8859-1".) |
| header6Font: font | Used in level 6 headers. (Default is "-adobe-times-bold-r-normal-*-10-*-*-*-*-*-iso8859-1".) |
| addressFont: font | Used in addresses. (Default is "-adobe-times-medium-i-normal-*-17-*-*-*-*-*-iso8859-1".) |
| plainFont: font | Used in plaintext regions or preformatted documents. (Default is "-adobe-courier-medium-r-normal-*-14-*-*-*-*-*-iso8859-1".) |
| listingFont: font | Used in listing regions. (Default is "-adobe-courier-medium-r-normal-*-12-*-*-*-*-*-iso8859-1".) |
| fixedboldFont: font | Used for bold in fixed (typewriter style) formatted text. |
| fixeditalicFont: font | Used for italics in fixed (typewriter style) formatted text. |
| plainboldFont: font | Used for bold in plaintext regions or preformatted documents. |
| plainitalicFont: font | Used for italic in plaintext regions or preformatted documents. |
| Previous | Next | Contents | Index |