OSMKIWEB - CONFIGURING THE IBM WEBEXPLORER FOR USE WITH CUSTOM
           EXTERNAL VIEWERS
01/25/96

=======================================================================
 Configuring the IBM WebExplorer for Use with Custom External Viewers
=======================================================================

Please Read Entire Document for Full Explanation of Procedures
--------------------------------------------------------------

DESCRIPTION

In certain situations, you might wish to configure WebExplorer to work 
with files that require a special application to view. For example, you 
might want to be able to view work files created with Microsoft 
PowerPoint. Usually, these files are distinctive, because they end with 
the extension "ppt."

RESOLUTION

Configuring EXPLORE.INI for Custom Viewers
------------------------------------------
In your EXPLORE.INI file (located in either \MPTN\ETC or \TCPIP\ETC), 
locate the following section:

   [advanced]
   ; advanced user settings - edit with care!
   ;
   ; mailcap= specifies full path to user mailcap file
   ; format is:  mime/type; program_name params %s
   ; example:    image/jpeg; jview -r %s
   ; no wildcards allowed, no piping, no UNIX commands
   mailcap=
   ; extmap= specifies full path to user extension map file
   ; format is:  mime/type     extension_list
   ; example:    image/jpeg    jpg jpeg jpe
   extmap=

You need to use this section to point to two files. The first file, 
MAILCAP=, tells WebExplorer what program you are going to use as a 
viewer. The second file, EXTMAP=, tells WebExplorer which file types 
(by extension) are to be viewed using the definitions in MAILCAP.

To begin, choose two file names. You will have to specify the full path 
and file name for each variable. For example:

   mailcap=C:\TCPIP\ETC\MAILCAP.TXT
   extmap=C:\TCPIP\ETC\EXTMAP.TXT

These files can be any name. Be sure that the path and file name are 
correct.

Configuring MAILCAP for Custom Viewers
--------------------------------------
In your EXPLORE.INI file, you chose a file name for a MAILCAP file. Now 
you need to create that file.

Using any text editor (E.EXE, EPM.EXE, TEDIT.EXE), create your file. In 
this example, name the file MAILCAP.TXT. In your MAILCAP file, use the 
following syntax:

   mime/type; program_name parameters %s

To set up Microsoft PowerPoint as an external viewer, use the following 
configuration:

   image/powerpoint; c:\powerpnt\powerpnt.exe %s

This tells WebExplorer that the mime type is an "image," the image type 
is "powerpoint," the program name is "c:\powerpnt\powerpnt.exe," and no 
parameters are passed. %s ends the entry.

The MAILCAP file can be used to set up as many viewers as your
environment requires. At this time, no limit has been found in the 
number of entries.

Configuring EXTMAP for Custom Viewers
-------------------------------------
In your EXPLORE.INI file, you chose a file name for a EXTMAP file. Now 
you need to create that file.

Using any text editor (E.EXE, EPM.EXE, TEDIT.EXE), create your file. In 
this example, name the file EXTMAP.TXT. In your EXTMAP file, use the 
following syntax:

   mime/type extension_list

To set up Microsoft PowerPoint as an external viewer, use the following 
configuration:

   image/powerpoint ppt

This tells WebExplorer that the mime type is an "image," the image type 
is "powerpoint," and files of this type have an extension of "ppt."

You can specify multiple extensions for each mime/type.

The "mime/type" entered must have a matching entry in your MAILCAP file.
Otherwise, the extensions you define have no program to run them.

_______________________________________________________________________
IBM disclaims all warranties, whether express or implied, including 
without limitation, warranties of fitness and merchantability with 
respect to the information in this document. By furnishing this 
document, IBM grants no licenses to any related patents or copyrights.  
Copyright (c) 1994, 1995 IBM Corporation. Any trademarks and product 
or brand names referenced in this document are the property of their 
respective owners. Consult your product manuals for complete trademark 
information.