                     EXCAL, THE WORKPLACE CALENDAR, VERSION 3.0

          If you are upgrading from ExCal 2.x, please read the section
          below titled "UPGRADING TO NEW VERSIONS OF EXCAL".

INSTALLING EXCAL ON YOUR SYSTEM FOR THE FIRST TIME:

1. Copy the EXCAL.DLL to C:\OS2\DLL, or another path listed in
   the LIBPATH statement in your CONFIG.SYS.

2. Copy the EXCAL.HLP to C:\OS2\HELP, or another path listed in
   the HELP environment variable in your CONFIG.SYS.

3. Run EXCINST.EXE to register the EXCAL.DLL and create an instance
   of ExCal.  EXCINST.EXE will prompt for the path you
   copied the EXCAL.DLL.

INSTALLING EXCAL ON YOUR SYSTEM FOR THE FIRST TIME *WITHOUT PROMPTING*:

   EXCINST path                   Where 'path' is where EXCAL.DLL
                                  was copied.
       -- or --

   EXCINST /USELIBPATH            If you copied EXCAL.DLL to a path
                                  on your LIBPATH.

   A progress dialog is displayed during installation.

ALSO INCLUDE IN THIS PACKAGE:

  EXCAL.CMD is the REXX equivalent of the installation utility 
  EXCINST.EXE.  It shows how the REXX API can be used to create and 
  modify ExCal objects.  

  Online help is available from any of the ExCal objects (calendar, event,
  time, place).

UPGRADING TO NEW VERSIONS OF THE EXCAL:

To upgrade, the EXCAL.DLL must be replaced.  But typically it is
"in use" by the system.  Here's three ways it can be replaced:

1. Add the line below:

     CALL=C:\OS2\CMD.EXE

   to the top of your CONFIG.SYS file and reboot.  A full screen
   session will be started before the Workplace Shell is started.  Copy
   the new EXCAL.DLL over the old and then EXIT to continue booting.
   Remember to remove (or comment out using REM) the line above in your
   CONFIG.SYS.

2. Or, another way:

   a. Rename the new EXCAL.DLL file to EXCAL.LLD (for downloading).
   b. Add the following lines to STARTUP.CMD, replacing 'x:\dir?'
      with the path you downloaded EXCAL.DLL (EXCAL.LLD) to:

      rem Allows replacing of EXCAL.DLL during boot
      IF NOT EXIST x:\dir?\EXCAL.LLD GOTO SKIPEXCAL
      DEL x:\dir?\EXCAL.DLL
      REN x:\dir?\EXCAL.LLD *.DLL
      :SKIPEXCAL

3. OS/2 Warp 3.0 users can press Alt+F1 when the "OS/2" and "white
   block" are shown during the boot sequence.  A dialog will be 
   displayed; choose C for command line, and copy new EXCAL.DLL
   over the old.  

After you have replaced EXCAL.DLL, some unneeded alarm files from the 
prior version must be deleted.  You can:

-- Run the Uninstall of EXCINST to delete the unneeded files of prior 
   versions and then re-run the Install of EXCINST to finish.

-- Or, replace the EXCAL.DLL as outlined above and follow the steps 
   below to remove the unneeded files.

   1. Open an OS/2 Command window.
   2. Change to your desktop directory, e.g.: 
          CD C:\DESKTOP
   3. Unhide the EXCAL*.ALM file(s):
          ATTRIB EXCAL*.ALM -h
   4. Delete the EXCAL*.ALM file(s):
          DEL EXCAL*.ALM
   5. Go to the Desktop and select "Refresh now".
   6. Go to the Calendar Glance view and select "Refresh now" from the
      View menubar pulldown.

   You may want to shutdown and reboot after completing these steps to 
   be certain the updates made by the Calendar during "Refresh now" are
   saved to disk.

NOTE 1: If you are upgrading from ExCal 2.x and do not run the Uninstall
        of EXCINST or don't follow the cleanup steps above, you're
        alarms will not work.  The hidden EXCAL*.ALM files(s) of the
        prior versions must be deleted for ExCal 3.0 alarms to work
        properly.  If you choose to run Uninstall, please verify the
        EXCAL*.ALM files were deleted by EXCINST before continuing.

NOTE 2: If you are upgrading from a version before 2.1d, you should run
        EXCINST to create new objects (address book, templates).  You
        can run EXCINST's Reinstall choice multiple times without
        any loss of data.

OS/2 WARP 3.0 USERS:

The Details view of the Calendar shows the columns below:

  Icon   Title   Object Class   Summary   Time and Place    Priority

The "Time and Place" column is a short version of the "Summary" column.
You can hide the former using the third "View" page of the Calendar's
Settings (this is done for you on 2.x versions of OS/2 by EXCINST.EXE).

Note: The "Object Class" column cannot be removed; this may be a Warp
      bug.
