231 lines
8.8 KiB
HTML
231 lines
8.8 KiB
HTML
|
|
||
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<html>
|
||
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
|
<title>Add SMTP List Entry (ADDSMTPLE)</title>
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</head>
|
||
|
|
<body bgcolor="white">
|
||
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<a name="ADDSMTPLE.Top_Of_Page"></a>
|
||
|
|
<h2>Add SMTP List Entry (ADDSMTPLE)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
||
|
|
<b>Threadsafe: </b>No
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#ADDSMTPLE.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#ADDSMTPLE.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#ADDSMTPLE.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="ADDSMTPLE"></a>
|
||
|
|
<p>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.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDSMTPLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="ADDSMTPLE.PARAMETERS.TABLE">Parameters</a></h3>
|
||
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
||
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
||
|
|
<tr>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDSMTPLE.TYPE"><b>TYPE</b></a></td>
|
||
|
|
<td valign="top">List type</td>
|
||
|
|
<td valign="top">*ACCEPT, *REJECT, *NEAR, *DOMAIN, *SVRBIND, *CLTBIND, *ETRNSVR, *FTRSUBJECT, *FTRORIGIN, *FTRFILNAME, *FTRTYPE</td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDSMTPLE.INTNETADR"><b>INTNETADR</b></a></td>
|
||
|
|
<td valign="top">Internet address</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDSMTPLE.SUBNETMASK"><b>SUBNETMASK</b></a></td>
|
||
|
|
<td valign="top">Subnet mask</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>'255.255.255.255'</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDSMTPLE.HOSTNAME"><b>HOSTNAME</b></a></td>
|
||
|
|
<td valign="top">Host name</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDSMTPLE.FTRDATA"><b>FTRDATA</b></a></td>
|
||
|
|
<td valign="top">Filter data</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDSMTPLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="ADDSMTPLE.TYPE"></a>
|
||
|
|
<h3>List type (TYPE)</h3>
|
||
|
|
<p>Specifies which list to add the new element to.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ACCEPT</b></dt>
|
||
|
|
<dd>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.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*REJECT</b></dt>
|
||
|
|
<dd>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.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NEAR</b></dt>
|
||
|
|
<dd>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.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DOMAIN</b></dt>
|
||
|
|
<dd>Specifies the domain to associate with each iSeries interface that the iSeries SMTP server will bind to.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SVRBIND</b></dt>
|
||
|
|
<dd>Specifies the iSeries interfaces that the iSeries SMTP server will bind to.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CLTBIND</b></dt>
|
||
|
|
<dd>The Client Bind list is updated. Specifies the interface the SMTP client should bind to.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ETRNSVR</b></dt>
|
||
|
|
<dd>The ETRN Server list is updated. Specifies the list of hosts from which the server will accept the ETRN command.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FTRSUBJECT</b></dt>
|
||
|
|
<dd>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.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FTRORIGIN</b></dt>
|
||
|
|
<dd>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.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FTRFILNAME</b></dt>
|
||
|
|
<dd>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.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FTRTYPE</b></dt>
|
||
|
|
<dd>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.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDSMTPLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDSMTPLE.INTNETADR"></a>
|
||
|
|
<h3>Internet address (INTNETADR)</h3>
|
||
|
|
<p>Specifies the internet address to add to the specified list. This address should be in dotted decimal format.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDSMTPLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDSMTPLE.SUBNETMASK"></a>
|
||
|
|
<h3>Subnet mask (SUBNETMASK)</h3>
|
||
|
|
<p>Specifies the mask to use with the internet address.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>255.255.255.255</u></b></dt>
|
||
|
|
<dd>This value selects only a single address value.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>subnet-mask</i></b></dt>
|
||
|
|
<dd>The mask to use with the internet address. Valid mask values are 128.0.0.0 - 255.255.255.255
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDSMTPLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDSMTPLE.HOSTNAME"></a>
|
||
|
|
<h3>Host name (HOSTNAME)</h3>
|
||
|
|
<p>Specifies the host name to add to the list.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDSMTPLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDSMTPLE.FTRDATA"></a>
|
||
|
|
<h3>Filter data (FTRDATA)</h3>
|
||
|
|
<p>Specifies the data to match when filtering.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDSMTPLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ADDSMTPLE.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Adding an Element to the Accept Relay List</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ADDSMTPLE TYPE(*ACCEPT) INTNETADR('1.2.3.4')
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>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.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Adding an Element to the Subject Filter List</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ADDSMTPLE TYPE(*FTRSUBJECT) FTRDATA('Love you.')
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>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.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDSMTPLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ADDSMTPLE.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>TCP1901</b></dt>
|
||
|
|
<dd>Internet address &1 not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP1903</b></dt>
|
||
|
|
<dd>Specified host name not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP264F</b></dt>
|
||
|
|
<dd>SUBNETMASK parameter value &2 not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP265F</b></dt>
|
||
|
|
<dd>INTNETADR parameter value &2 not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP8050</b></dt>
|
||
|
|
<dd>*IOSYSCFG authority required to use &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>TCP96AE</b></dt>
|
||
|
|
<dd>Duplicate entry found in SMTP list type &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9847</b></dt>
|
||
|
|
<dd>Error occurred while closing file &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9848</b></dt>
|
||
|
|
<dd>Cannot open file &1 in library &2 member &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9849</b></dt>
|
||
|
|
<dd>Error while processing file &1 in library &2 member &3.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDSMTPLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|