User Guide > Process Steps and Components > Queue Step > POP3 Email Queue
Was this helpful?
POP3 Email Queue
Note:  For general information about Queue Steps, see Queue Step.
POP3 Email Queue supports receiving text and binary attachments. Actian DataConnect supports POP3 Email Queue versions 1.0.2 and 1.3.0.
The following table provides the supported content types.
Content Type
Details
text/*
• text
• HTML
image/*
• .gif
• .jpg
application/*
• All applicable applications, such as .xls, .zip, and .doc
The email components support encoding in all character sets when an email is sent and received. The message header and body are encoded in the character set specified by the MIME. In addition, the email components support only Base64 and other MIME encoding. Enriched encoding is not supported.
Note:  The POP3 Email Queue component implicitly trust the certificates presented by the email servers that require SSL or TLS connections, regardless of the issuer.
 
POP3 Email Queue Properties
 
Property
Description
User Name
Username to connect to the POP3 email server.
Password
The password to authenticate the above username.
Server Name
Name of the POP3 email server
Port
Port to be used to connect to the server.
The default value is: 110
Note:  If the default port is not used, then the component assumes a secure (SSL or TLS) connection is required.
ConnectionTimeout
Connection time out value in seconds.
The default value is: 90
Retry Count
Number of attempts the server tries to establish connection when the connection times out or fails.
The default value is: 3
From Contains
From email address. For more information, see note.
To Contains
To email address. For more information, see note.
Subject Contains
Subject value. For more information, see note.
Browse Mode
Select from TRUE or FALSE:
• TRUE - If this is selected, the email message remains on the server even after it is download.
• FALSE - (default) If this is selected, the email message is deleted from the server after it is download.
Download
Download the read and/or unread messages from the server:
• ALL - Download both read and unread messages from the server.
• READ - Download only read messages from the server.
• UNREAD - (default) Download only unread messages from the server.
Note:  This property is displayed only for POP3 Email Queue version 1.0.2.
Encoding String
Encoding string required for the email from the list.
The default value is: ISO-8859-1
Mark Failed Messages as Seen
Select from TRUE or FALSE:
• TRUE - Marks unprocessed messages as seen. This value provides a method to bypass messages that the component cannot handle by marking them as read.
• FALSE - (default) Leaves unprocessed messages as unseen.
Note:  This property is displayed only for POP3 Email Queue version 1.3.0.
Always Create Attachment Messages
Select from TRUE or FALSE:
• TRUE - Component encodes any primary content that may be an email attachment, and then includes it into a new DJMessage attachment. The original content normally has a MIME type indicating that it is binary data.
• FALSE - (default) Component places any primary content that may be an email attachment in the main DJMessage. The original content normally has a MIME type indicating that it is text data.
Note:  If the email is not multi-part MIME- formatted, then the content is included in the main DJMessage regardless of the MIME type.This property is displayed only for POP3 Email Queue version 1.3.0.
Note:  If any combination of From Contains, To Contains, or Subject Contains filter properties are specified, then all emails (limited by the value of the Download property) that contain a match in the corresponding From, To, or Subject matching fields will be returned. In other words, the logical matching condition applied is OR.
Tip...  You can set filters or flags using the From Contains, To Contains, and Subject Contains properties. However, the filters do not work if the server does not support the same.
Supported Actions
Action
Description
Connect
Opens a persistent connection to the database.
GetMessage
Retrieves message into a message object.
Disconnect
Closes an existing database connection and performs any clean up actions if required.
Supported Action Parameters
Action
Parameter
Description
GetMessage
Message
Name for the incoming message
Supported Action Properties
There are no supported action properties.
Errors
Errors are generated when email messages cannot be sent or received due to various reasons. Typical errors include the following:
• Connection timeout
• Unable to disconnect from the email server
• Errors while sending email messages
• Errors while Receiving email messages
• Miscellaneous or unknown errors
All errors are written to an error log, which you can read to diagnose and troubleshoot the problem. The error messages specify whether a problem occurred while receiving or sending.
The error log also contains error codes that help you to identify and understand the cause of the error.
The following table describes error codes generated while sending or receiving email.
Code
Description
19
Unable to connect to the mail server
27
Unable to disconnect from the mail server
8
Unable to send email
4
Unable to receive email
50
Unknown error
1
End of file
12
No more messages to download
0
Messages sent or received successfully
Last modified date: 12/03/2024