Configuration tasks required for the connector

You must perform the following configuration tasks for the connector:

Configuring the connector MAPI profile

A Microsoft Outlook profile must be created on the machine where the Outlook client and the Exchange connector are installed. This profile ensures that all necessary Exchange folders are configured correctly.

Create the Outlook profile for the connector as follows:

  1. Start the Outlook client on the machine where the connector is installed.
  2. When Outlook prompts you to specify a mailbox, enter the name of the Exchange user you created in Setting up a user account and permissions for event sinks.
  3. When prompted by Outlook, register Outlook as the default client for e-mail messages and contacts.
  4. When Outlook prompts you to open additional mailboxes, select the mailbox for each Outlook user who can generate events. This enables the connector to access the mailboxes for these users.

Outlook creates a profile that is named Ms Exchange Settings by default.

Note:
The value you specify for the connector's ProfileName configuration property must exactly match the Outlook MAPI profile name.

Verifying profile properties

If you are using MailItem business objects, you must verify the profile's properties, as follows:

Note:
You do not need to do this task if you are using only AppointmentItem, ContactItem, or TaskItem business objects.
  1. Open the Windows Control Panel and double-click the Mail icon. The profile_name Properties dialog box opens, where profile_name is the name of the profile you just created (by default, MS Exchange Settings).
  2. Select the Microsoft Exchange Server service and click Properties. The Microsoft Exchange Server dialog box opens.
  3. On the General tab, verify that the values in the Microsoft Exchange server and Mailbox fields are correct.
  4. On the Advanced tab, verify the following:
  5. Click OK to exit the Microsoft Exchange Server dialog box, and then click OK to exit the profile_name Properties dialog box.

Creating the Archive Store

When you created the Outlook profile in Configuring the connector MAPI profile, the Event Store was automatically created. You must now create the Archive Store to hold archived events, as follows:

  1. Open the Outlook client and select Outlook Today -- [Mailbox - user_name].
  2. Create a new folder with the following values. Refer to your Outlook documentation for more information on creating new folders.

    Table 6. Field values for the Archive Store folder

    Field name Value to enter
    Name Archive
    Note:
    This value must be used for the connector's ArchiveFolder configuration property.
    Folder contains Mail Items
    Select where to place the folder Mailbox--user_name, where user_name is the name of the account you want to use for the Archive Store. You can use any account, as long as the Exchange user has acceess to it.

Setting connector configuration properties

The connector component of the adapter has two types of configuration properties: standard configuration properties and application-specific configuration properties. You must set the values of these properties before running the connector.

Standard configuration properties

To configure standard connector properties, use the Connector Configurator tool. Details are given in "Connector Configurator". This tool provides a graphical user interface for configuring the connector. Click on the Standard Config Properties tab to add or modify configuration properties.

When you have finished specifying values for the connector's configuration properties, Connector Configurator saves the values in the adapter repository (for ICS) or generates a configuration file and places it in the adapter's local repository (for WebSphere MQ Integrator Broker).

A connector obtains its configuration values at startup. During a run-time session, you may want to change the values of one or more connector properties.

To determine whether a property is dynamic or static, refer to the update method column in Connector Configurator.

Application-specific configuration properties

Application-specific connector configuration properties provide information needed by the connector at run time. They also provide a way for you to change static information or logic within the connector without having to recode and rebuild it.

To configure these properties, use Connector Configurator. Click the Application Config Properties tab to add or modify configuration properties. For more information, see "Connector Configurator".

Table 7 lists the application-specific configuration properties for the connector, along with their descriptions and possible values.


Table 7. Application-specific configuration properties for Exchange Server

Property Description Possible values Default value Required?
ArchiveFolder Fully qualified name of directory where events are archived The full path name for the event archive directory (for example, Mailbox - User1/Archive)
Yes
ArchiveProcessed Specifies how events are archived. true, false

For a detailed description of archive behavior, see Event archiving.

true Yes
DateFormat Specifies the format of Date attributes in the business object. The format is based on the java.text.SimpleDateFormat class Any valid combination of date symbols (for example, MM/dd/yyyy HH:mm:ss). Common symbols include:
  • y--year
  • M--month
  • d--day
  • h--hour in A.M. or P.M. (1--12)
  • H--hour in the day (0--24)
  • m--minute
  • s--second
  • S--millisecond
  • a--designation of A.M. or P.M.
MM/dd/yyyy HH:mm:ss Yes
EventFolder Fully qualified name of directory where events are stored The full path name for the event directory (for example, Mailbox - User1/Inbox)
Yes
InDoubtEvents Specifies how to handle events that were IN_PROGRESS when the connector terminated
  • FailOnStartup--A fatal error is logged, email notification is sent, and FAIL is returned
  • Reprocess--The events' status is changed to READY_FOR_POLL so they can be picked up during the next poll
  • LogError--An error is logged
  • Ignore--The events are ignored

Reprocess Yes
ProfileName Name of MAPI profile used to log on to Exchange Server Any valid MAPI profile name
Yes

Copyright IBM Corp. 1997, 2003