               Lotus cc:Mail VIM Runtime for OS/2 Release 2.01
               ===============================================

This file contains information on installing the provided VIM Runtime DLLs.
The DLLs included on this disk are v2.01 of the VIM Runtime set and provide
support for new functionality found in the Lotus VIM Developer's Toolkit 
Release 2.0.

If you still have questions about the DLLs or their installation after you have 
read this file, please call cc:Mail Technical Support at (415) 966-4900.


Table of Contents
=================
File List
Installation
Compatibility
Updates
Modifications In This Release


File List
=========

README.TXT (This file)
VIM.DLL
SMI.DLL
MEMMAN.DLL
MAILENG.DLL
CHARSET.DLL
SMISET.EXE


Installation
============

To install cc:Mail VIM Runtime into your network cc:Mail program directory
you will need administrator access to the directory and all users must
shut down mail.  Lotus recommends these DLLs are installed into the
cc:Mail program directory either on the network drive or locally.

To install, copy all the files found on this diskette to your cc:Mail program
directory.  It is important to copy ALL the DLLs as they are a matched set.
DO NOT COPY THESE DLLS INTO A DIRECTORY THAT CONTAINS NEWER VERSIONS OF ANY
OF THE DLLS.  Check the time/date stamps to insure you're not copying old
dlls over new ones.

If you are running client machines that need SMI functionality, you will
need to ensure that the following section and variable are present in the
OS2.INI file for each client machine:

    [Mail]
    SMI=1

Since the OS2.INI file is a binary file and may not be edited (or viewed)
using a text editor, we have included a utility on this disk which will
check the OS2.INI file and set the variable if necessary.  This utility
program is called SMISET.EXE and may be run from the OS2 command line.  
To run the program type:

[d:\path\]smiset <enter>

where [d:\path\] represents the path to the smiset.exe program.

The smiset program will inform you that it is about to add the section shown
above to your OS2.INI file.  You will be given the opportunity to confirm
the modification, or to cancel by pressing <ctrl-c>.  

Note that this modification must be performed on EVERY client machine that
will be using SMI functionality, and that the cc:Mail for OS2 WPS release 1.0
installation program does not make this modification.

Compatibility
=============

cc:Mail VIM Runtime for OS/2 Release 2.01 is compatible with all cc:Mail for
OS/2 3.2 and greater platform packs and cc:Mail for OS/2 WPS 1.0 and greater 
platform packs.  These DLLs are an update to those included in the Lotus 
cc:Mail for OS/2 WPS Release 1.0 platform pack, and are compatible with 
level 6 cc:Mail post offices.

Updates
=======

This DLL set can be updated either by upgrading your cc:Mail platform pack,
or by installing a newer VIM Runtime dll set.  Always refer to the README.TXT
file included with the upgrade being installed for information on new features
and bug fixes.


Modifications In This Release
=============================

This runtime release fixes a memory management bug in maileng.dll that exists
in the cc:Mail for OS2 WPS release 1.0 which caused applications using the
mail engine to trap when other applications that were also using the mail 
engine were running concurrently.

This release implements the VIMGetEntityName functionality slightly 
differently than either the Windows or DOS versions of VIM.  In both Windows
and DOS, specifying a NULL session will return the default name as described 
in the Lotus VIM Developer's Toolkit Programmers Guide.  In OS/2, however, 
the operating system memory management model does not allow implememtation 
of this functionality.  Under OS/2, VIMGetEntityName with a NULL session 
parameter will return VIMSTS_NO_DEFAULT.


Known Problems With This Release
================================

There is a known initialization bug that manifests itself as follows:
A VIM application that loads the VIM dlls but does not open a session will
prevent other VIM applications and cc:Mail for OS/2 WPS running on the same 
machine from accessing the mail engine.  This does not occur if the first 
VIM app opens a session, even if the app immediately closes the session 
afterward.

Terminating a VIM app with <ctrl-c> will cause other VIM applications running
on the same machine to hang.

Attempting to dynamically load VIM using DosLoadModule() does not work
correctly when the complete path is specified.  Use the name "VIM" instead,
and make sure the directory where the VIM dlls are located is in the
LIBPATH.

