38.1. POP3 resource

38.1. POP3 resource
	Chapter 38. POP3 - Post Office Protocol 3

POP3 or Post Office Protocol - Version 3 is, along with IMAP, one of the protocols used by a host computer to receive e-mail.

38.1.1. Activating the POP3 resource

Add the resource to the Abilis system with the following command:

[10:19:28] ABILIS_CPX:a res:pop3

COMMAND EXECUTED

	Caution
	After adding or setting the POP3 active, you must restart the Abilis to make the resource running (use the command warm start to reboot the Abilis)

[10:21:03] ABILIS_CPX:s p pop3 act:yes

COMMAND EXECUTED

38.1.2. POP3 resource parameters

Use the following command to display the parameters of the resource; the d p pop3 ? command shows the meaning of parameters.

[10:57:36] ABILIS_CPX:d p pop3
RES:Pop3 ----------------------------------------------------------------------
Run    DESCR:Post_Office_Protocol_Ver3
       LOG:NO         ACT:YES              tcp-locport:110  TOS:0-N
       sesnum:10      DT:300               MAX-IP-SES:2
       DOMAIN:
       wdir:C:\APP\MAIL\
       MSG-LIFETIME:2419200                AUTH:ANY
       IPSRC:127.000.000.001               IPSRCLIST:PrivateIpAdd

Meaning of the most important parameters:

LOG:

Logging functionalities activation/deactivation.

ACT

Runtime SMTP activation/deactivation.

tcp-locport

Local TCP port on which SMTP service is listening [1..65535].

TOS

Used to establish the frame priority. First field [default: 0] Second field specify the type of the frame [N=None, D=Min. Delay, T=Max. Throughput, R=Max. Reliability, C=Min. Monetary Cost].

sesnum

Number of sessions [1..255].

DT

Inactivity disconnection time-out [30..65535 sec.].

MAX-IP-SES

Maximum number of simultaneous incoming sessions from the same IP address [1..255].

DOMAIN

POP3 server domain name. From 0 up to 64 characters in the range ['0'..'9', 'a'..'z', '-', '.']. DN name is forced to lower case.

wdir

Working directory where the messages are stored. Full path with drive letter ['C'..'Z'] terminated by '\'. Max 128 chars. Spaces require double quotes (E.g. "C:\My dir\").

MSG-LIFETIME

Amount of seconds before a received mail is deleted by the server if still not downloaded by a client [86400..10368000 sec, NOMAX].

AUTH

Pop3 accepted authentication types: [ANY, PROTECTED, PLAIN].

ANY - any POP3 authentication type is accepted.

PROTECTED - POP3 authentication by APOP or AUTH commands.

PLAIN - POP3 authentication by USER/PASS commands.

IPSRC

Incoming requests: accepted source IP address [*, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].

IPSRCLIST

Incoming requests: list of further accepted source IP addresses [#, IP/IR/RU/MR listname].

The command that allows the configuration of the resource to be modified has the following syntax:

s p pop3 par:val...

	Caution
	To activate the changes made on the upper case parameters, execute the initialization command init res:pop3; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. With warm start command).


Chapter 38. POP3 - Post Office Protocol 3		38.2. Example of configuration of the POP3 resource