Configuring the Email Listener

In your email system, create an account for user "Subscription Agent".
Define the email address for the Subscription Agent person:
1. In Business Modeler, locate the Person object for Subscription Agent and open it for editing.
2. On the Address tab, enter the email address defined in step 1
3. Make sure the Email check box is checked and not IconMail.
4. Click Modify.
Enter values for these elements in the mailListener.xml file, located in the INSTALL/conf directory:

mailBox protocol--The protocol used by your mail server; must be POP or IMAP.

user--Email account to be monitored for incoming email. The person "Subscription Agent" is created and installed for this purpose.

If the user name for a POP or IMAP account requires a domain identifier, such as username@company.com, replace the @ symbol with the hexadecimal value for the + symbol (%2B). If you use the + symbol itself, encoding rules change it to a space when sent to the mail server, so make sure you use the hexadecimal value, %2B, such as username%2Bcompany.com.

password--The email account password for the above user.

mailHost--The internet address of the host for the email server.

interval--Time between polling for incoming messages, in milliseconds.

jpo--Name of the JPO to execute when email is found in the polled account. Unless you create a custom JPO:method, you should not change this value.

matrixUrl--The URL of the server (RMI or WebServer).

RMI in process mode is not supported by MailListener.

This code shows the config.xml file as installed:
```
<?xml version="1.0" encoding="utf-8"?>
```
```
<matrixMailListener>
```
```
  <mailBox protocol=POP>
```
```
    
```
```
    <user>Subscription.Agent</user>
```
```
    <password>MailBoxPassword</password>
```
```
    <mailHost>MailHost</mailHost>
```
```
    <interval>PollingInterval</interval>
```
```
    <jpo> emxSubscriptionReplyHandler  -method captureMailInfo</jpo>
```
```
    <MatrixUrl>Matrix Server Url</MatrixUrl>   
```
```
   </mailBox>
```
```
  <mailBox protocol=IMAP>
```
```
    
```
```
    <user>Subscription.Agent</user>
```
```
    <password>MailBoxPassword</password>
```
```
    <mailHost>MailHost</mailHost>
```
```
    <interval>PollingInterval</interval>
```
```
    <jpo> emxSubscriptionReplyHandler  -method captureMailInfo</jpo>
```
```
    <MatrixUrl>MatrixUrl</MatrixUrl> 
```
```
   </mailBox> 
```
```
</matrixMailListener> 
```
Start the email listener daemon:

On UNIX: execute mailListener.sh in the INSTALL/scripts directory.
On Windows: execute mailListener.bat in the INSTALL/bin/winnt directory.