Configuration tasks required for the connector

You must perform the following configuration tasks for the connector:

Creating the Connector's User Acount

In most cases, the Exchange_User account you created in Setting up a user account and permissions for event sinks is the same account that the connector should use. If your installation for some reason requires that the connector's account not be the same as the Exchange_User account, use Windows system administration tools to create that account.

Creating the Archive Store

When you log into Outlook with the connector's user account for the first time, Outlook will automatically create the Inbox which serves as the adapter's Event Store. You must also create an additional mail folder for that account to serve as the Archive Store, as follows:

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

    Table 7. 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. Normally this would be the Exchange_User account, but any account the connector has access to is acceptable.

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 Appendix B, "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 Appendix B, "Connector Configurator".

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


Table 8. Application-specific configuration properties for the Exchange connector

Property Description Possible values Default value Required?
ArchiveFolderURI Fully qualified name of directory where events are archived The full path name for the event archive directory
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
EventFolderURI Fully qualified name of directory where events are stored The full path name for the event directory
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
WindowsName Connector's user name (usually the same as Exhange_User). Used to log on to Exchange Server Any valid logon name
Yes
WindowsPassword The password for the WindowsName account Any valid password
Yes
RecipientBusiness
Obj
Determines the name of the
Recipient child business object
Any text string Recipient No
RecurrencePattern
BusinessObj
Determines the name
of the RecurrencePattern child
business object
Any text string RecurrencePattern No

Copyright IBM Corp. 1997, 2004