Bookshelf Home | Contents | Index | Search | PDF | ![]() ![]() ![]() ![]() |
Siebel eMail Response Administration Guide > Tables and Reference >
How the Internet SMTP/POP3 Driver Processes Email Messages
This section contains some information about email directories, driver parameters, and an overview of how the Internet SMTP/POP3 Server driver processes email messages. For details about the directories and driver parameters included in this section, see Siebel Communications Server Administration Guide.
Email Directories and Driver Parameters
When the Internet SMTP/POP3 Server driver starts, it creates the following directories and by default puts them in the bin subdirectory, if they do not exist. By default, the following directories are created:
- Failed
- Incoming
- Loopback
- Processed
- Sent
If you do not wish to store messages in the bin subdirectory, you can specify a different location by changing the values for the communications driver parameters. To change the locations where messages are stored, navigate to the Communications Administration screen and select the Communications Drivers and Profiles view. In the Driver Parameters list, choose one of the following parameters for the directory location that you want to change, and type a directory path in the Default Value column.
- Failed Email Directory
- Incoming Email Directory
- Loopback Email Directory
- Processed Email Directory
- Sent Email Directory
The following parameters control how incoming and outgoing messages are processed:
- Delete Processed Messages
- Save Sent Messages
- Return Attachments
- Process If Loopback Detected
You can change how these email messages are processed by changing the Default Value of a driver parameter. For example, if you do not want to return attachments, change the default value to FALSE.
An Overview of the Processing Flow of Inbound Email Messages
When the Internet SMTP/POP3 Server driver starts, it creates required directories such as Incoming Email. The Internet SMTP/POP3 Server driver also creates a thread that polls the POP3 server. The PollingInterval driver parameter controls the frequency at which the Internet SMTP/POP3 Server driver checks the POP3 server for messages.
If there are messages, the Internet SMTP/POP3 Server driver retrieves and processes them one at a time, up to a maximum per session equal to the value set in the POP3 Batch Size driver parameter. If the current session with the POP3 server terminates abnormally, all messages previously retrieved, processed, and deleted during the current session will be restored, retrieved, and processed again the next time the Internet SMTP/POP3 Server driver connects to the POP3 server. The smaller the value POP3 Batch Size driver parameter, the fewer duplicate messages will be created and processed if a restart occurs.
Messages in a session are processed as shown in the following steps:
- A message is saved in the Incoming Email directory.
- The POP3 DELE command deletes the message from the POP3 server.
If the DELE command fails, the message stored in the Incoming Email directory is erased because it will be retrieved again in the next POP3 session.
NOTE: You should not have other email clients accessing the mailboxes that eMail Response is monitoring because the email driver deletes the messages from the POP3 server when they are processed by eMail Response. As such, these messages will not be visible from another client.
- The disk based message is parsed. The parsing produces the following files in the Incoming Email directory:
- OriginalMessageText_[the original header of the message along with all text parts concatenated together].txt.
- Any attachments parsed from message are given unique names in the following format:
ATT_[the original header of the message along with all text parts concatenated together].DAT.
- Any remaining text or HTML fragments are turned into attachments and are given unique names in the following format:
ATT_[the original header of the message along with all text parts concatenated together].DAT.
- If an error occurs when the message is parsed, the following events occur:
- A temporary file in the following format is moved to the Failed Email directory and any attachments created are deleted:
pop3_[the original header of the message along with all text parts concatenated together].tmp
- The POP3 session is immediately terminated with a QUIT command so that the offending message is permanently deleted from the server.
- If the Loopback Detection Interval parameter value is greater than zero and the message sender is currently being blocked, the following events occur:
- If the Process If Loopback Detected parameter value is FALSE, the message is moved to the Loopback Email directory.
- If the Process If Loopback Detected parameter value is TRUE, the driver's Loopback Candidate flag is set to TRUE and the message continues processing.
- If the message is not moved to the Loopback Email directory or flagged as a loopback candidate, the pop3_[the original header of the message along with all text parts concatenated together].tmp file is processed as follows:
- If the Delete Processed Messages parameter value is TRUE, the temporary file is deleted.
- If the Delete Processed Messages parameter value is FALSE, the temporary file is moved to the Processed Email directory.
- The primary message text, header information (subject, to, cc, date, and so on), Loopback Candidate flag, and references to the attachments are passed to the driver's creator (usually Communications Inbound Manager, or CIM).
- The OriginalMessageText file and all the attachments are not deleted by the SMTP/POP3 driver. It is the responsibility of the workflow invoked by CIM to delete all the attachments.
CAUTION: Any errors that occur in the workflows may strand the ATT_OriginalMessageText files in the Incoming Email folder. If this occurs while CIM is not running, the workflow invoked by CIM failed to process a message event. The safe way to determine if an ATT_OriginalMessageText file can be deleted is to stop CIM and then look at the contents of all the queued CIM Events in all response groups to make sure that the ATT_OriginalMessageText files are no longer being referenced.
Bookshelf Home | Contents | Index | Search | PDF | ![]() ![]() ![]() ![]() |
Siebel eMail Response Administration Guide Published: 21 April 2003 |