PowerExchange for Email Server User Guide for PowerCenter

PowerExchange for Email Server User Guide for PowerCenter

Configuring Sessions for Email Sources

Configuring Sessions for Email Sources

The following table describes the properties for email sources that you can configure while configuring an email session:
Session Property
Description
Idle Time
Time in seconds for which the PowerCenter Integration Service waits to receive new email messages before it ends the session. Default is -1 and indicates an infinite period of time.
Message Count
Number of messages the PowerCenter Integration Service reads before ending the session. Default is -1 and indicates an infinite number of messages.
Reader Time Limit
Time in seconds to read emails from the source for a stipulated period of time. When you choose the Reader Time Limit session property, the PowerCenter Integration Service reads messages from the source for the time period you specify. After that, the PowerCenter Integration Service stops reading from the email source and ends the session. Default is 0 and indicates an infinite period of time.
Real-time Flush Latency
Configures the session in real time. When the value of the Real-time Flush Latency session property is greater than 0, the session runs in real time, and the PowerCenter Integration Service commits retrieved email data to the target at the end of a specified maximum latency period. The maximum latency period is determined by a combination of the values of Real-time Flush Latency, Message Count, and Reader Time Limit. Default is 0 and indicates that the PowerCenter Integration Service does not run the session in real-time mode.
Poll Interval
Time in seconds to poll the mail server for new emails after the specified time interval. Default is 10 and indicates that the PowerCenter Integration Service polls the mail server for new emails after an interval of 10 seconds. When you specify 0, the PowerCenter Integration Service continuously polls the mail server for new emails.
Retrieve
Retrieves emails from a mail folder based on the following options:
  • All. Retrieves all emails from the mail folder.
  • Read. Retrieves read emails from the mail folder.
  • Unread. Retrieves unread emails from the mail folder.
  • Recent. Retrieves emails that have arrived since the last time you accessed the mail folder on a mail server using any email client or the PowerCenter Integration Service.
Mark Retrieved Emails As
Marks retrieved emails based on the following options:
  • Don’t Mark. Does not mark the retrieved emails as unread, read, or deleted.
  • Read. Marks retrieved emails as read.
  • Unread. Marks retrieved emails as unread.
  • Deleted. Marks retrieved emails as deleted.
To avoid reading the same emails each time a session runs, configure a real-time session to retrieve unread emails and mark them as Read.
By default, the PowerCenter Integration Service runs the session in non-real time mode. In real-time mode, you can configure the Retrieve and Mark Retrieved Mails As session properties. In addition, to run the session in the real-time mode, you need to configure the following session properties:
  • Idle Time
  • Message Count
  • Reader Time Limit
  • Real Time Flush Latency
  • Poll Interval
By default, all emails are retrieved and they are not marked upon retrieval as read, unread, or deleted. You cannot mark retrieved emails on mail server as Read, Unread, or Deleted when a folder is opened in read-only mode.
You can view load statistics in the session log. The load summary in the Workflow Monitor does not display load statistics.