========================================================================
Support Note: 10
Product:      The Operations Pack (TOP)
Version:      All versions
Title:        Enabling Email When Using Microsoft Outlook
Created:      20 May 2003
Updated:      10 July 2008

Copyright 2008 Gresham Software Labs Pty Ltd


========================================================================
Problem Description
========================================================================

TOP uses the Collaboration Data Objects (CDO) to access the Messaging
Application Programming Interface (MAPI).

Formerly known as OLE Messaging and Active Messaging, CDO is an object
model that gives applications more direct access to the MAPI.

The MAPI is used by Microsoft Outlook to structure its data storage. CDO
support is automatically installed when versions of Outlook before
Outlook 2000 are installed. CDO support is not automatically installed
when versions of Outlook from and after Outlook 2000 (such as Outlook
2002/XP) are installed.

Two options for MAPI are available within TOP - pick the one appropriate
for your version of Outlook.

Outlook is used to send and receive email. The System Explorer, Pathway
Manager and Spooler Manager can use email to distribute jobs, files and
messages. If TOP uses the MAPI interface for email distribution and CDO
support is not available when these programs attempt to use email the 
attempt fails.


========================================================================
Problem Solution
========================================================================

The solution is to install CDO support when you install Outlook.

Follow the instructions below to install CDO support:

For versions of Outlook before Outlook 2007:

1. Obtain the correct Microsoft Office installation CD (for example,
   Microsoft Office 2000 or Microsoft Office 2002/XP).

2. Close TOP, if running.

3. Do one of the following:

   a. If you have not yet installed Outlook, follow these instructions:

      i.    Click Start, point to Settings, and then click Control
            Panel.

      ii.   Click Add New Programs

      iii.  Click CD or Floppy.

      iv.   Follow the instructions on the screen to run the Microsoft
            Office installation program.

      v.    Click the plus sign (+) next to Microsoft Outlook for
            Windows to open it.

      vi.   Click Collaboration Data Objects, and then click Run from My
            Computer.

      vii.  Click Install Now.

   b. If you have already installed Outlook, follow these instructions:

      i.    Close Outlook, if running.

      ii.   Click Start, point to Settings, and then click Control
            Panel.

      iii.  Double-click Change or Remove Programs.

      iv.   In the list, click either Microsoft Office or Microsoft
            Outlook, and then click Change.

      v.    Click Add or Remove Features.

      vi.   Click the plus sign (+) next to Microsoft Outlook for
            Windows to open it.

      vii.  Click Collaboration Data Objects, and then click Run from My
            Computer.

      viii. Click Update Now.

4. Restart TOP.



For Outlook 2007:  

Microsoft no longer ship CDO as part of Office. The software is available
on the Microsoft web-site.

1. Obtain the CDO software installer directly from Microsoft:
http://tinyurl.com/6lw6ej

2. Close TOP, if running.

3. Install CDO using the installer.

4. Restart TOP.


========================================================================
Problem Status
========================================================================

This is an installation issue with Microsoft Outlook 2000 and later. TOP
development and support staff cannot resolve this issue. Therefore, you
must ensure that you install CDO support whenever you install Outlook.


END OF SUPPORT NOTE ====================================================