The Add SMTP List Element (ADDSMTPLE) command is used to add elements to SMTP configuration lists. These lists may be enabled or disabled using the Change SMTP Attributes (CHGSMTPA) command or from the SMTP Properties panel in iSeries Navigator. The changes take effect the next time the SMTP server is started either by the Start TCP/IP (STRTCP) command or by the Start TCP/IP Server (STRTCPSVR) command.

Restrictions:

• You must have input/output system configuration (*IOSYSCFG) special authority to use this command.

Parameters

Keyword	Description	Choices	Notes
TYPE	List type	*ACCEPT, *REJECT, *NEAR, *DOMAIN, *SVRBIND, *CLTBIND, *ETRNSVR, *FTRSUBJECT, *FTRORIGIN, *FTRFILNAME, *FTRTYPE	Required, Positional 1
INTNETADR	Internet address	Character value	Optional
SUBNETMASK	Subnet mask	Character value, '255.255.255.255'	Optional
HOSTNAME	Host name	Character value	Optional
FTRDATA	Filter data	Character value	Optional

Top

List type (TYPE)

Specifies which list to add the new element to.

*ACCEPT

The Accept Relay list is updated. Specifies a list of IP addresses with netmasks that will be allowed to relay when "Accept relay messages from" is selected on the SMTP Properties Relay Restrictions page on iSeries Navigator.

*REJECT

Adds an IP address and netmask to the Relay Restrictions list. This a list of IP addresses with netmasks that will be rejected if they try to connect to the iSeries SMTP.

*NEAR

Adds a domain to the Near Domain list. The Near Domain list is a list of domains for which mail should not be routed through the firewall, when "Forward outgoing mail to router through firewall" is selected on the SMTP Properties General page in iSeries Navigator. Also specifies SMTP should relay mail for recipients whose domains are in the Near Domain list when "Relay mail for only these domains" is selected.

*DOMAIN

Specifies the domain to associate with each iSeries interface that the iSeries SMTP server will bind to.

*SVRBIND

Specifies the iSeries interfaces that the iSeries SMTP server will bind to.

*CLTBIND

The Client Bind list is updated. Specifies the interface the SMTP client should bind to.

*ETRNSVR

The ETRN Server list is updated. Specifies the list of hosts from which the server will accept the ETRN command.

*FTRSUBJECT

The Subject Filter list is updated. Adds an item to the Subject comparison list. Mail is discarded or quarantined, as specified on the SMTP properties Filters Page, if comparison conditions are met.

*FTRORIGIN

The Originator Filter list is updated. Adds an item to the Originator's address comparison list. Mail is discarded or quarantined, as specified on the SMTP properties Filters Page, if comparison conditions are met.

*FTRFILNAME

The File Name Filter list is updated. Adds an item to the "Filename / extension comparison" list. Mail is discarded or quarantined, as specified on the SMTP properties Filters Page, if comparison conditions are met.

*FTRTYPE

The File Type Filter list is updated. Adds an item to the Type / subtype comparison list. Mail is discarded or quarantined, as specified on the SMTP properties Filters Page, if comparison conditions are met.

Internet address (INTNETADR)

Specifies the internet address to add to the specified list. This address should be in dotted decimal format.

Subnet mask (SUBNETMASK)

Specifies the mask to use with the internet address.

255.255.255.255

This value selects only a single address value.

subnet-mask

The mask to use with the internet address. Valid mask values are 128.0.0.0 - 255.255.255.255

Host name (HOSTNAME)

Specifies the host name to add to the list.

Filter data (FTRDATA)

Specifies the data to match when filtering.

Examples

Example 1: Adding an Element to the Accept Relay List

ADDSMTPLE   TYPE(*ACCEPT)  INTNETADR('1.2.3.4')

This command adds an address 1.2.3.4 to the Accept Relay list. The assumed mask is 255.255.255.255. This means that this address can be used to connect to the SMTP server to relay mail to another server.

Example 2: Adding an Element to the Subject Filter List

ADDSMTPLE   TYPE(*FTRSUBJECT)  FTRDATA('Love you.')

This command adds an element to the Subject Filter list. Any mail with an exact match to the subject 'Love you.' will be filtered as specified by the CHGSMTPA attributes.

Error messages

*ESCAPE Messages

TCP1901

Internet address &1 not valid.

TCP1903

Specified host name not valid.

TCP264F

SUBNETMASK parameter value &2 not valid.

TCP265F

INTNETADR parameter value &2 not valid.

TCP8050

*IOSYSCFG authority required to use &1.

TCP96AE

Duplicate entry found in SMTP list type &1.

CPF9847

Error occurred while closing file &1 in library &2.

CPF9848

Cannot open file &1 in library &2 member &3.

CPF9849

Error while processing file &1 in library &2 member &3.