Email Receiver

Definition

Protocol

POP

Description

Retrieve email messages using POP protocol from Host on Port (default 110) using Login.
Check messages every TimeInterval and do Not delete messages from the server.
Truncate message body size to Number bytes.

Comments

If Host is blank, missing or invalid, the receiver will be disabled.

Event Field	Contents
ev:host	ECS hostname
ev:app	Email
ev:log	POP sever/user:port
ev:protocol	"POP"& version #

If Port is blank, missing, invalid or equal to zero, retrieve messages from port 110.

If TimeInterval is blank, missing, invalid or equal to zero, retrieve messages every 10 minutes. The minimum TimeInterval is 15 seconds.

If the message deletion policy is not specified, messages are not deleted.

Attachments are ignored.

If the message body size is not specified or less than or equal to zero, the full message body is retrieved into (ev:email.msgBody field).

Special XML characters are translated according to the XML character translation table.

Example

<source objectId="EmailRecv1" type="EmailReceiver" stdout="FS.DemoAlive">
	<parameter type="Host">eventgnosis.pop02</parameter>
	<parameter type="Port">102</parameter>
	<parameter type="Login">
		<user>joe</user>
		<password>joepass</password>
	</parameter>
	<parameter type="TimeInterval">
		<time>10</time>
		<units>min</units>
	</parameter>
	<parameter type="Not"></parameter>
	<parameter type="Number">10000</parameter>
</source>

Event Mapping

Incoming Mail message

{
	From: “John Smith” jsmith@yahoo.com
	Subject: Support request
	Body: This is the message body.
}

Resulting XML

<event xmlns:ev="http://www.eventgnosis.com/">
	<ev:host>yahoo.com</ev:host>
	<ev:app>Email</ev:app>
	<ev:log> www.myMailServer.com/joe:110</ev:log>
	<ev:srctime> Oct 10, 2003 17:22:13 PM </ev:srctime>
	<ev:protocol>POP v3.4</protocol>
	<ev:email.from>John Smith</ev:from>
	<ev:email.fullemail>jsmith@yahoo.com</ev:fullemail>
	<ev:email.subject> Support request</ev:subject>
	<ev:email.msgBody>This is the complete message body.</ev:email.msgBody>
	<ev:msg>Message body up to 1K characters. Add “...” if more and truncate</ev:msg>
</event>