1227 lines
48 KiB
HTML
1227 lines
48 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>Change SMTP Attributes (CHGSMTPA)</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="CHGSMTPA.Top_Of_Page"></a>
|
|
<h2>Change SMTP Attributes (CHGSMTPA)</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="#CHGSMTPA.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGSMTPA.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGSMTPA.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGSMTPA"></a>
|
|
<p>The Change SMTP Attributes (CHGSMTPA) command is used to change common SMTP attributes such as retries, name delimiters, mail router, and the automatic registration of remote users into the system directory. The changes made by this command take effect the next time SMTP is started.
|
|
</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="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGSMTPA.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="#CHGSMTPA.AUTOSTART"><b>AUTOSTART</b></a></td>
|
|
<td valign="top">Autostart server</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGSMTPA.RTYMIN"><b>RTYMIN</b></a></td>
|
|
<td valign="top">Retries by minute</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Number of retries</td>
|
|
<td valign="top">
|
|
0-99, <b><u>*SAME</u></b>, *DFT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Time interval</td>
|
|
<td valign="top">
|
|
0-99, <b><u>*SAME</u></b>, *DFT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGSMTPA.RTYDAY"><b>RTYDAY</b></a></td>
|
|
<td valign="top">Retries by day</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Number of retries</td>
|
|
<td valign="top">
|
|
0-9, <b><u>*SAME</u></b>, *DFT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Time interval</td>
|
|
<td valign="top">
|
|
0-9, <b><u>*SAME</u></b>, *DFT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGSMTPA.RTYHOUR"><b>RTYHOUR</b></a></td>
|
|
<td valign="top">Retries by hour</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Number of retries</td>
|
|
<td valign="top">
|
|
0-99, <b><u>*SAME</u></b>, *DFT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Time interval</td>
|
|
<td valign="top">
|
|
0-99, <b><u>*SAME</u></b>, *DFT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.RTYRMTSVR"><b>RTYRMTSVR</b></a></td>
|
|
<td valign="top">Retry remote name server</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.AUTOADD"><b>AUTOADD</b></a></td>
|
|
<td valign="top">Automatic registration</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.USRIDPFX"><b>USRIDPFX</b></a></td>
|
|
<td valign="top"> User ID prefix</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.ADDRESS"><b>ADDRESS</b></a></td>
|
|
<td valign="top"> Address</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.SYSNAME"><b>SYSNAME</b></a></td>
|
|
<td valign="top"> System name</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.TBLTYPE"><b>TBLTYPE</b></a></td>
|
|
<td valign="top"> Alias table type</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *SYSTEM, *PERSONAL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.USRIDDELIM"><b>USRIDDELIM</b></a></td>
|
|
<td valign="top">User ID delimiter</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *DFT, '?', '=', '.', '&', $, #, '/', '+', '_', '-', *, '"'</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.MAILROUTER"><b>MAILROUTER</b></a></td>
|
|
<td valign="top">Mail router</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.CCSID"><b>CCSID</b></a></td>
|
|
<td valign="top">Coded character set identifier</td>
|
|
<td valign="top">1-65533, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#CHGSMTPA.TBLSMTPOUT"><b>TBLSMTPOUT</b></a></td>
|
|
<td valign="top">Outgoing EBCDIC/ASCII table</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *CCSID, *DFT<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Outgoing EBCDIC/ASCII table</td>
|
|
<td valign="top">
|
|
<i>Qualified object name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Outgoing EBCDIC/ASCII table</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="4"><a href="#CHGSMTPA.TBLSMTPIN"><b>TBLSMTPIN</b></a></td>
|
|
<td valign="top">Incoming ASCII/EBCDIC table</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *CCSID, *DFT<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Incoming ASCII/EBCDIC table</td>
|
|
<td valign="top">
|
|
<i>Qualified object name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Incoming ASCII/EBCDIC table</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CHGSMTPA.FIREWALL"><b>FIREWALL</b></a></td>
|
|
<td valign="top">Firewall</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.JOURNAL"><b>JOURNAL</b></a></td>
|
|
<td valign="top">Journal</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.ALLMAILMSF"><b>ALLMAILMSF</b></a></td>
|
|
<td valign="top">Process all mail through MSF</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.PCTRTGCHR"><b>PCTRTGCHR</b></a></td>
|
|
<td valign="top">Percent routing character</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#CHGSMTPA.DIALSCD"><b>DIALSCD</b></a></td>
|
|
<td valign="top">Dial-up scheduler</td>
|
|
<td valign="top">Single values: *NO<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Start with SMTP server</td>
|
|
<td valign="top">
|
|
<b><u>*SAME</u></b>, *YES</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Configuration profile</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Connection time interval</td>
|
|
<td valign="top">
|
|
1-1440, <b><u>*SAME</u></b>, *NONE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.ETRNSVR"><b>ETRNSVR</b></a></td>
|
|
<td valign="top">Support ETRN for server</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#CHGSMTPA.ETRNCLT"><b>ETRNCLT</b></a></td>
|
|
<td valign="top">Support ETRN for client</td>
|
|
<td valign="top">Single values: *NO<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Enable client ETRN</td>
|
|
<td valign="top">
|
|
<b><u>*SAME</u></b>, *YES</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Incoming mail server address</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Mail domain name</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.MIME8BIT"><b>MIME8BIT</b></a></td>
|
|
<td valign="top">Support 8-bit MIME</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="2"><a href="#CHGSMTPA.NFYDLVRY"><b>NFYDLVRY</b></a></td>
|
|
<td valign="top">Delivery status notification</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="2">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Responsible person</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGSMTPA.SBSD"><b>SBSD</b></a></td>
|
|
<td valign="top">Subsystem description</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *DFT<br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Subsystem description</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CHGSMTPA.RBLSVR"><b>RBLSVR</b></a></td>
|
|
<td valign="top">Realtime Blackhole List</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.ALWRLY"><b>ALWRLY</b></a></td>
|
|
<td valign="top">Allow relayed mail</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE, *ALL, *BOTH<br>Other values (up to 3 repetitions): *LIST, *NEAR, *POPWDW</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.POPWDW"><b>POPWDW</b></a></td>
|
|
<td valign="top">POP send mail window</td>
|
|
<td valign="top">15-65535, <b><u>*SAME</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.IFCDMN"><b>IFCDMN</b></a></td>
|
|
<td valign="top">Interface/domain association</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *NONE, *LIST</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSMTPA.FTRACN"><b>FTRACN</b></a></td>
|
|
<td valign="top">Filter mail for virus</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *NONE, *KEEP, *DISCARD</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGSMTPA.AUTOSTART"></a>
|
|
<h3>Autostart server (AUTOSTART)</h3>
|
|
<p>Specifies whether to start the SMTP server automatically when TCP/IP is started by running the Start TCP/IP (STRTCP) command, or the Start TCP/IP Server (STRTCPSVR) command with SERVER(*AUTOSTART) specified. When SMTP is started by running the STRTCPSVR command, this parameter is ignored; the SMTP server is started regardless of the value of this parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The autostart value that was previously set does not change; otherwise, *YES is used.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Automatically start the SMTP server.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Do not automatically start the SMTP server.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.RTYMIN"></a>
|
|
<h3>Retries by minute (RTYMIN)</h3>
|
|
<p>Specifies the number of attempts and the number of minutes between attempts for SMTP to distribute mail and to retry the remote name server. If the number specified is used and is not successful, the daily retries that are specified by the RTYHOUR parameter are attempted.
|
|
</p>
|
|
<p><b>Element 1: Number of retries</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The number of retries that was previously set does not change; otherwise, 3 is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The number of first-level distribution retries is set to the default of 3.
|
|
</dd>
|
|
<dt><b><i>0-99</i></b></dt>
|
|
<dd>Specify the number of retries to be attempted.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Time interval</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The number of minutes between retries that was previously set does not change; otherwise, 30 is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The number of minutes between retries is set to the default of 30 minutes.
|
|
</dd>
|
|
<dt><b><i>0-99</i></b></dt>
|
|
<dd>Specify the number of minutes between retries. If a number of retries is set, the time interval must be set to something other than 0. A recommended time interval is something greater than 5 minutes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.RTYDAY"></a>
|
|
<h3>Retries by day (RTYDAY)</h3>
|
|
<p>Specifies the number of attempts and the number of days between attempts for SMTP to distribute mail and to retry the remote name server. The RTYDAY parameter is used when the RTYMIN parameter was not successful. If the number of RTYDAY attempts is used and is not successful in distributing mail, a status distribution note is returned to the sender. Because the default on the RTYDAY parameter is set to 0 for the number of retries, this level of retry is not used unless intentionally set by the customer. Either, the RTYDAY or RTYHOUR parameter may be chosen for Second Level retry, but not both.
|
|
</p>
|
|
<p><b>Element 1: Number of retries</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The number of retries that was previously set does not change; otherwise, 0 is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The number of retries is set to the default of 0.
|
|
</dd>
|
|
<dt><b><i>0-9</i></b></dt>
|
|
<dd>Specify the number of retries to be attempted. If the number of retries is set, the time interval must be something other than 0.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Time interval</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The number of days between retries that was previously set does not change; otherwise, 0 is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The number of days between retries is set to the default of 0 day.
|
|
</dd>
|
|
<dt><b><i>0-9</i></b></dt>
|
|
<dd>Specify the number of days between retries. If the number of retries is set, the time interval must be something other than 0.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.RTYHOUR"></a>
|
|
<h3>Retries by hour (RTYHOUR)</h3>
|
|
<p>Specifies the number of attempts and the number of hours between attempts for SMTP to distribute mail and to retry the remote name server. The RTYHOUR parameter is used when the RTYMIN parameter was not successful. If the number of retries is greater than zero, and the time interval is greater than zero for RTYHOUR parameter, the RTYDAY parameter values are not used. If the number of RTYHOUR attempts is used and is not successful in distributing mail, a status distribution note is returned to the sender. Because the default on the RTYHOUR parameter is set to 0 for the number of retries, this level of retry is not used unless intentionally set by the customer.
|
|
</p>
|
|
<p><b>Element 1: Number of retries</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The number of retries that was previously set does not change; otherwise, 0 is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The number of retries is set to the default of 0.
|
|
</dd>
|
|
<dt><b><i>0-99</i></b></dt>
|
|
<dd>Specify the number of retries to be attempted. If the number of retries is set, the time interval must be something other than 0.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Time interval</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The number of hours between retries that was previously set does not change; otherwise, 0 is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The number of hours between retries is set to the default of 0 minutes.
|
|
</dd>
|
|
<dt><b><i>0-99</i></b></dt>
|
|
<dd>Specify the number of hours between retries. If the number of retries is set, the time interval must be something other than 0.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.RTYRMTSVR"></a>
|
|
<h3>Retry remote name server (RTYRMTSVR)</h3>
|
|
<p>Specifies whether SMTP should retry contacting the remote name server when attempts to contact it are unsuccessful. The RTYMIN and RTYHOUR/RTYDAY parameters are used to determine the frequency of retries.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value for the RTYRMTSVR parameter that was previously set does not change; otherwise, *NO is used.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Try to contact the remote name server again.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Do not attempt to contact the remote name server again.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.AUTOADD"></a>
|
|
<h3>Automatic registration (AUTOADD)</h3>
|
|
<p>Specifies, for incoming mail, whether the remote user ID and address are automatically added to the system directory and, if necessary, to an alias table. This enables the local user to respond to the mail without first entering the necessary data into the directory and the alias table.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The automatic registration value that was previously set does not change; otherwise, *NO is used.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Do not automatically add remote users into the system directory and the alias table.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Automatically add remote users into the system directory and the alias table.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.USRIDPFX"></a>
|
|
<h3>User ID prefix (USRIDPFX)</h3>
|
|
<p>Specifies the 3-character prefix that is to be used with the generated 5-digit number that together make up the SNADS user ID. The SNADS user ID is automatically added to the system directory and the alias table. This parameter takes effect only if the AUTOADD parameter is set to *YES.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The user ID prefix value that was previously set does not change; otherwise, QSM is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The 3-character user ID prefix is set to the default of QSM.
|
|
</dd>
|
|
<dt><b><i>communications-name</i></b></dt>
|
|
<dd>Specify the 3-character user ID prefix to be used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.ADDRESS"></a>
|
|
<h3>Address (ADDRESS)</h3>
|
|
<p>Specifies the SNADS address to be generated when remote users are to be automatically added to the system directory and the alias table. This parameter takes effect only if the AUTOADD parameter is set to *YES.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The address value that was previously set does not change; otherwise, QSMRMTAD is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The SNADS address to be automatically added is the default of QSMRMTAD.
|
|
</dd>
|
|
<dt><b><i>communications-name</i></b></dt>
|
|
<dd>Specify the SNADS address to be automatically added to the system directory and the alias table. Up to 8 characters can be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.SYSNAME"></a>
|
|
<h3>System name (SYSNAME)</h3>
|
|
<p>Specifies the name that SNADS uses to route mail to SMTP. This name should match the distribution routing specified when SMTP was configured. This parameter takes effect only if the AUTOADD parameter is set to *YES.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The system name value that was previously set does not change; otherwise, TCPIP is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>SNADS uses the default system name of TCPIP to route mail to SMTP.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the system name to be used by SNADS to route mail to SMTP. Up to 8 characters can be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.TBLTYPE"></a>
|
|
<h3>Alias table type (TBLTYPE)</h3>
|
|
<p>Specifies the type of SMTP alias table to be updated with the remote users information if remote users are to be automatically added to the system directory. This parameter takes effect only if the AUTOADD parameter is set to *YES.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The table type value that was previously set does not change; otherwise, *SYSTEM is used.
|
|
</dd>
|
|
<dt><b>*SYSTEM</b></dt>
|
|
<dd>Update the SMTP system alias table with the remote user information.
|
|
</dd>
|
|
<dt><b>*PERSONAL</b></dt>
|
|
<dd>Update the SMTP personal alias table for the local user with the remote user information.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.USRIDDELIM"></a>
|
|
<h3>User ID delimiter (USRIDDELIM)</h3>
|
|
<p>Specifies the single character delimiter to be used to separate parts of the SMTP user ID. All subsequent entries in the system and personal alias tables use this new character. The special characters must be enclosed in apostrophes.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The user ID delimiter value that was previously set does not change; otherwise, a question mark ('?') is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The single character delimiter is the question mark (?).
|
|
</dd>
|
|
<dt><b><i>delimiter-character</i></b></dt>
|
|
<dd>The single character delimiter to be used to separate parts for the SMTP user ID. Only one of the following characters can be specified:
|
|
<ul>
|
|
<li>Question mark (?)
|
|
</li>
|
|
<li>Equal sign (=)
|
|
</li>
|
|
<li>Period (.)
|
|
</li>
|
|
<li>Plus sign (+)
|
|
</li>
|
|
<li>Ampersand (&)
|
|
</li>
|
|
<li>Underscore (_)
|
|
</li>
|
|
<li>Dash (-)
|
|
</li>
|
|
<li>Dollar sign ($)
|
|
</li>
|
|
<li>Number sign (#)
|
|
</li>
|
|
<li>Asterisk (*)
|
|
</li>
|
|
<li>Quotation marks (")
|
|
</li>
|
|
<li>Forward slash(/)
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.MAILROUTER"></a>
|
|
<h3>Mail router (MAILROUTER)</h3>
|
|
<p>Specifies that a mail router should be used when SMTP cannot find the name and address of the recipient in the system or personal alias tables or when SMTP is not able to resolve the address of the recipient. If you do not want mail routing, you must specify *NONE.
|
|
</p>
|
|
<p><b>Note:</b> When MAILROUTER(*NONE) is defined, then the FIREWALL parameter will be ignored by the SMTP server.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The mail router previously set does not change; otherwise, *NONE is used.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No mail router is used.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the route that outgoing mail on the local system is to take first. Up to 256 characters can be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.CCSID"></a>
|
|
<h3>Coded character set identifier (CCSID)</h3>
|
|
<p>Specifies the ASCII coded character set identifier (CCSID) that is used to map all single-byte character set (SBCS) data on outgoing mail. This value is also assumed to be the ASCII CCSID for mapping all SBCS data for incoming mail. Mapping is determined by the specified ASCII CCSID and the EBCDIC CCSID of the job.
|
|
</p>
|
|
<p>The CCSID value chosen is the default used by SMTP for ASCII-to-EBCDIC and EBCDIC-to-ASCII mapping. Outgoing and incoming mapping can be done optionally with mapping tables defined in the TBLSMTPOUT and TBLSMTPIN parameters. Normally the TBLSMTPOUT and TBLSMTPIN parameters are set to the default of *CCSID or *DFT. Both values indicate that the value used in the CCSID parameter is used for mapping.
|
|
</p>
|
|
<p>If a mapping table is used for outgoing mapping, a table object can be specified in the TBLSMTPOUT parameter. The table object specified in the TBLSMTPOUT parameter is used instead of the CCSID value.
|
|
</p>
|
|
<p>Incoming mapping can be changed to use a mapping table by specifying a table object in the TBLSMTPIN parameter. This mapping table overrides the specified CCSID value and is used for incoming mapping.
|
|
</p>
|
|
<p>Double-byte character set (DBCS) CCSID values are not permitted for this parameter. DBCS data is self-identifying in SMTP mail.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The CCSID value that was previously set does not change; otherwise, 00819 (ISO 8859-1 8-bit ASCII) is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The CCSID value is 00819 (ISO 8859-1 8-bit ASCII).
|
|
</dd>
|
|
<dt><b><i>1-65533</i></b></dt>
|
|
<dd>Specify the CCSID value to be used. This value is validated to ensure a valid SBCS CCSID was requested.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.TBLSMTPOUT"></a>
|
|
<h3>Outgoing EBCDIC/ASCII table (TBLSMTPOUT)</h3>
|
|
<p>Specifies the outgoing mapping table used by the SMTP client to map outgoing mail from EBCDIC to ASCII.
|
|
</p>
|
|
<p>If a table object is specified for TBLSMTPOUT, the table object is used for outgoing mapping. Otherwise, the CCSID parameter is used to determine outgoing mapping.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The TBLSMTPOUT value does not change if it was previously set; otherwise, *CCSID is used.
|
|
</dd>
|
|
<dt><b>*CCSID</b></dt>
|
|
<dd>The CCSID parameter is used to determine outgoing mapping.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The CCSID parameter is used to determine outgoing mapping.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Outgoing EBCDIC/ASCII table</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the outgoing mapping table.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the user and system portions of the job's library list are searched until the first match is found.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.TBLSMTPIN"></a>
|
|
<h3>Incoming ASCII/EBCDIC table (TBLSMTPIN)</h3>
|
|
<p>Specifies the incoming mapping table used by the SMTP server to map incoming data from ASCII to EBCDIC.
|
|
</p>
|
|
<p>If a table object is specified for the TBLSMTPIN parameter, the table object is used for incoming mapping. Otherwise, the CCSID parameter is used to determine incoming mapping.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The TBLSMTPIN value does not change if it was previously set; otherwise, *CCSID is used.
|
|
</dd>
|
|
<dt><b>*CCSID</b></dt>
|
|
<dd>The CCSID parameter is used to determine incoming mapping.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The CCSID parameter is used to determine incoming mapping.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Outgoing EBCDIC/ASCII table</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the incoming mapping table.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the user and system portions of the job's library list are searched until the first match is found.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.FIREWALL"></a>
|
|
<h3>Firewall (FIREWALL)</h3>
|
|
<p>Specifies whether outbound mail, destined for a host in a remote domain, should be forwarded to the configured mail router to get through the network's firewall.
|
|
</p>
|
|
<p><b>Note:</b> When MAILROUTER(*NONE) is defined, then the FIREWALL parameter will be ignored by the SMTP server.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The firewall value that was previously set does not change; otherwise, *NO is used.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Forward the mail to the mail router machine, if it is for a host that is outside the iSeries system's domain.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Just send the mail to the recipient's host machine.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.JOURNAL"></a>
|
|
<h3>Journal (JOURNAL)</h3>
|
|
<p>Specifies whether SMTP should write additional journal entries which show mail message transitions, events, and informational data to the Mail Server Framework journal (QUSRSYS/QZMF) as each mail item passes thru SMTP.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value for the JOURNAL parameter that was previously set does not change; otherwise, *NO is used.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Write additional journal entries as the mail passes thru SMTP.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Do not make any additional journal entries.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.ALLMAILMSF"></a>
|
|
<h3>Process all mail through MSF (ALLMAILMSF)</h3>
|
|
<p>Specifies whether the SMTP server should process all mail that it receives, even mail that is not addressed to the iSeries that the server is running on, and pass it into the Mail Server Framework.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value for the ALLMAILMSF parameter that was previously set does not change; otherwise, *NO is used.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Pass all mail that the SMTP Server receives into the Mail Server Framework.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Only pass mail into the Mail Server Framework if it is addressed to the iSeries the server is running on.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.PCTRTGCHR"></a>
|
|
<h3>Percent routing character (PCTRTGCHR)</h3>
|
|
<p>Specifies whether the SMTP Server should interpret the '%' character as an SMTP routing character, or allow the character to just pass through. Lotus Notes uses the '%' character as a default separator character for fully qualifying a Lotus Note domain name, ie. John_Smith%NotesDomain1%NotesDomain2@host.domain.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value for the PCTRTGCHR parameter that was previously set does not change; otherwise, *NO is used.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Interpret the '%' character as an SMTP routing character.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Treat the '%' as just another character.
|
|
<p><b>Note:</b> You should select *NO, if you use Lotus Notes, or you exchange mail with a Lotus Notes domain.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.DIALSCD"></a>
|
|
<h3>Dial-up scheduler (DIALSCD)</h3>
|
|
<p>Determines if the SMTP scheduler should be started to handle dial-up connections. The scheduler is started as a separate SMTP job. An initial connection is first made using the communications profile to establish either a SLIP or PPP link. The waiting mail is sent, then the job sleeps for the time interval specified. When the time interval expires, the Scheduler reestablishes the communication link and sends any waiting mail accumulated during the interval.
|
|
</p>
|
|
<p><b>Note:</b> Delivery attempts resulting from the scheduler are not counted as retries. (see RTYMIN and RTYHOUR parameters)
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Do not start the SMTP scheduler when the SMTP server is started. If *NO is specified, values for the configuration profile name and the time interval are ignored.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Start with SMTP server</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The requested use of the scheduler that was previously set does not change; otherwise, *NO is used.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Start the SMTP scheduler when the SMTP server is started. If *YES is specified, the configuration profile name (element 2) must be specified on this invocation or a previous invocation of the command.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Configuration profile</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The requested configuration profile that was previously entered is not changed.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the configuration profile (PPP or SLIP connection profile) to be used by the scheduler.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Connection time interval</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The requested time interval that was previously set is not changed; otherwise, 30 minutes is used.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No retries will be performed.
|
|
</dd>
|
|
<dt><b><i>1-1440</i></b></dt>
|
|
<dd>Specify the number of minutes between connection attempts. This time measurement begins when the scheduler sees that the connection has been successful or receives a failure indication other that the profile not existing. Any other failure as a result of an attempted connection will cause the scheduler to end with message TCP2285 sent to to the QSYSOPR message queue.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.ETRNSVR"></a>
|
|
<h3>Support ETRN for server (ETRNSVR)</h3>
|
|
<p>Specifies whether the SMTP server will support the ETRN command from a remote host's client.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value for the ETRNSVR parameter that was previously set does not change; otherwise, *NO is used.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The server will retry all its mail when an ETRN command is received from a host.domain that is in the accept ETRN list. The accept ETRN list can be specified by using the iSeries Navigator SMTP properties pages or by using the ADDSMTPLE(Add SMTP List Entry) command and specifying *ETRNSVR for the TYPE parameter.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The server will respond with the "502 Command not implemented" when the ETRN command is received. <b>Note:</b>ETRN will not be included in the list of supported extensions when an EHLO response is sent to a querying client.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.ETRNCLT"></a>
|
|
<h3>Support ETRN for client (ETRNCLT)</h3>
|
|
<p>Specifies whether an ETRN command will be issued to an internet service provider's (ISP's) incoming mail server when a dial-out connection is made. The connection's profile is the one defined in the DIALSCD parameter.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Do not enable the client's ETRN. If *NO is specified, values for address of incoming mail server and mail domain name are ignored.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Enable client ETRN</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The requested use of the client's ETRN that was previously set does not change; otherwise, *NO is used.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The SMTP job will make an SMTP connection to the Internet Service's provider incoming mail server's IP address. Once a successful connection is received, the ETRN command will be sent to that server. When *YES is entered, the address of incoming mail server (element 2) and mail domain name (element 3) must be specified on this invocation or a previous invocation of CHGSMTPA.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Incoming mail server address</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The configured internet address that was previously entered is not changed.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the address of the ISP's incoming mail server in dotted decimal format: nnn.nnn.nnn.nnn
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Mail domain name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The configured mail domain name that was previously entered is not changed.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the name of the host.domain that the ISP provides mail storage service for on behalf of this iSeries system.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.MIME8BIT"></a>
|
|
<h3>Support 8-bit MIME (MIME8BIT)</h3>
|
|
<p>Specifies whether the 8BITMIME extension is honored by the SMTP server. The SMTP client will try to send the 8BITMIME message (for relayed mail cases), but will send a non-delivery notice to the originator if the destination's mail server does not support 8BITMIME. No conversion will be done.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>Use the same value for MIME8BIT that was previously set; otherwise, *NO is used.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The server will honor 8BITMIME mail transfers.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The server will not honor 8BITMIME transfers.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.NFYDLVRY"></a>
|
|
<h3>Delivery status notification (NFYDLVRY)</h3>
|
|
<p>Specifies whether Delivery Status Notification (DSN) is supported and, if supported, the address to use in the "from" field in the delivery status notification.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>Use the same value for NFYDLVRY that was previously set; otherwise, *NONE is used.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Delivery Status Notification will not be supported. No "from" field address is provided.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the SMTP address, in the format "userid@host.domain", that is used in the "from" field inside a delivery status notification. This should be a valid SMTP address. Up to 255 characters can be specified.
|
|
<p>The server will honor a request for Delivery Status Notification from an SMTP client. Status notes, indicating delivery, delay, relay or failure of a note to a recipient, will be generated as requested.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.SBSD"></a>
|
|
<h3>Subsystem description (SBSD)</h3>
|
|
<p>Specifies the subsystem description of the subsystem where SMTP server jobs are to run. If the specified subsystem description does not exist, it is created. If the library does not exist where the description is to be created, the command will fail.
|
|
</p>
|
|
<p>If a subsystem description other than an IBM-supplied *SBSD QSYSWRK is specified, a job queue is also created with the same name and in the same library as the specified subsystem description. This job queue is used for submitting SMTP server jobs.
|
|
</p>
|
|
<p>*READ, *ADD, and *EXECUTE authorities are required to the library where the subsystem description and/or job queue are created. If the subsystem description already exists, *READ, *EXECUTE, *OBJMGT and *OBJOPR authorities to the object are required otherwise this command will fail. If the job queue already exists, *READ, *EXECUTE, *OBJMGT, and *OBJOPR authorities are required to that object; otherwise the command will fail. For an existing subsystem description and job queue, the QTCP user profile will be granted *USE authority to these objects.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd> Use the same value for SBSD that was previously set; otherwise, *DFT is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>When *DFT is specified, the SMTP server jobs are submitted to job queue QSYSNOMAX in library QSYS and run in the QSYSWRK subsystem.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Subsystem description</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the subsystem description that SMTP will use for its server jobs.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.RBLSVR"></a>
|
|
<h3>Realtime Blackhole List (RBLSVR)</h3>
|
|
<p>Specify the fully-qualified domain names of the servers to query that are running a Realtime Blackhole List (RBL). If no entry is found for the mail originator's address in the reject connections list, a query will be sent to each RBL server specified in this parameter before mail is accepted for delivery or relay. The reject connections list can be set by using iSeries Navigator SMTP properties pages or by using the ADDSMTPLE command with *REJECT specified for the TYPE parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>Use the same value for RBLSVR that was previously set; otherwise, *NONE is used.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No Realtime Blackhole List is used.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the list of Realtime Blackhole List servers to be searched, up to three server names may be specified, separated by spaces and enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.ALWRLY"></a>
|
|
<h3>Allow relayed mail (ALWRLY)</h3>
|
|
<p>Specifies the whether to allow relay mail through this server.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd> Use the same value for ALWRLY that was previously set; otherwise, *NONE is used.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No mail will be relayed.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All relayed mail will be allowed.
|
|
</dd>
|
|
<dt><b>*BOTH</b></dt>
|
|
<dd>Allow both addresses listed in the relay messages list (*LIST) and addresses to recipients in the near domains (*NEAR) to be relayed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values (up to 3 repetitions)</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*LIST</b></dt>
|
|
<dd>Addresses listed in the accept relay messages list will be relayed. The accept relay messages list can be specified by using iSeries Navigator SMTP properties pages or by using the ADDSMTPLE command with a value of *ACCEPT specified for the TYPE parameter.
|
|
<p><b>Note:</b> iSeries POP users on this system should be added to this list if this iSeries is to act as their outbound SMTP server. Any message from POP users must be relayed.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*NEAR</b></dt>
|
|
<dd>Relay mail addressed to any recipients in the near domain list. The domain list can be defined using Operations Navigator SMTP properties pages or by using the ADDSMTPLE (Add SMTP List Entry) command and specifying *NEAR for the TYPE parameter.
|
|
</dd>
|
|
<dt><b>*POPWDW</b></dt>
|
|
<dd>Relay mail for any client who has logged on to the Post Office Protocol (POP) server within the number of minutes specified by the parameter POP send mail window (POPWDW). This requires that a receive POP mail must be done before a send mail is requested by the client.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.POPWDW"></a>
|
|
<h3>POP send mail window (POPWDW)</h3>
|
|
<p>Specifies the number of minutes to allow a client to send mail, using the SMTP server, to addresses other than a local address. The time starts for each client when the client logs on to the POP server to receive mail.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change if it was previously set; otherwise *NONE is used.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>The clients will not be allowed to relay mail after logging on to the POP server.
|
|
</dd>
|
|
<dt><b><i>15-65535</i></b></dt>
|
|
<dd>Specify the time interval, in minutes, after logging on to POP that the client can send relay mail using SMTP.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.IFCDMN"></a>
|
|
<h3>Interface/domain association (IFCDMN)</h3>
|
|
<p>Specifies whether SMTP should associate domains with specific interfaces.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value for the IFCDMN parameter that was previously set does not change; otherwise, *NONE is used.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No domains will be associated with a specific interface. The local domain is associated with all interfaces.
|
|
</dd>
|
|
<dt><b>*LIST</b></dt>
|
|
<dd>Use the association that is defined in the domain list. The domain list contains the IP address and the domain names that are associated with them. The domain list can be defined by using the iSeries Navigator SMTP properties pages or by using the ADDSMTPLE (Add SMTP List Entry) command and specifying *DOMAIN for the TYPE parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSMTPA.FTRACN"></a>
|
|
<h3>Filter mail for virus (FTRACN)</h3>
|
|
<p>Allows mail to be scanned and either discarded or quarantined if a set of conditions are met. These conditions are:
|
|
</p>
|
|
<ul>
|
|
<li>Subject comparison
|
|
</li>
|
|
<li>Filename/Extension comparison
|
|
</li>
|
|
<li>Type/Subtype in Content-Type comparison
|
|
</li>
|
|
<li>Originator's address
|
|
</li>
|
|
</ul>
|
|
<p>The Subject comparison records are defined by using iSeries Navigator SMTP properties pages or by using the Add SMTP List Entry (ADDSMTPLE) command with a value of *FTRSUBJECT.
|
|
</p>
|
|
<p>The Filename/Extension records are defined by using iSeries Navigator SMTP properties pages or by using the ADDSMTPLE command with a value of *FTRFILNAME.
|
|
</p>
|
|
<p>The Type/Subtype records are defined by using iSeries Navigator SMTP properties pages or by using the ADDSMTPLE command with a value of *FTRTYPE.
|
|
</p>
|
|
<p>The Originator records are defined by using iSeries Navigator SMTP properties pages or by using the ADDSMTPLE command with a value of *FTRORIGIN.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>Use the same value for FTRACN that was previously set; otherwise, *NONE is used.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No comparison will be made.
|
|
</dd>
|
|
<dt><b>*KEEP</b></dt>
|
|
<dd>Keep this message and move it to '/qtcptmm/ftrfiles' but do not send it if the comparison is made.
|
|
</dd>
|
|
<dt><b>*DISCARD</b></dt>
|
|
<dd>Discard this message if a comparison is made.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGSMTPA.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Changing the POP Send Time to 2 Hours</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGSMTPA ALWRLY(*POPWDW) POPWDW(120)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the SMTP attributes to allow a POP client to send mail using the local SMTP server to any remote address for 2 hours (120 minutes) after logging on to the POP server to check mail.
|
|
</p>
|
|
<p><b>Example 2: Allow Relay for Addresses on List</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGSMTPA ALWRLY(*LIST)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the SMTP attributes to allow clients using IP address on a list to send relay mail.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGSMTPA.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF0011</b></dt>
|
|
<dd>Error detected by prompt override program.
|
|
</dd>
|
|
<dt><b>TCP160B</b></dt>
|
|
<dd>Search list limited to six domain names.
|
|
</dd>
|
|
<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>TCP2432</b></dt>
|
|
<dd>User name exceeds maximum length of &1 bytes.
|
|
</dd>
|
|
<dt><b>TCP2434</b></dt>
|
|
<dd>Specified user name not valid.
|
|
</dd>
|
|
<dt><b>TCP2436</b></dt>
|
|
<dd>Configuration profile name required.
|
|
</dd>
|
|
<dt><b>TCP261D</b></dt>
|
|
<dd>Process did not complete successfully
|
|
</dd>
|
|
<dt><b>TCP264D</b></dt>
|
|
<dd>Error occurred processing file.
|
|
</dd>
|
|
<dt><b>TCP499A</b></dt>
|
|
<dd>Error accessing configuration member.
|
|
</dd>
|
|
<dt><b>TCP4993</b></dt>
|
|
<dd>CCSID parameter value &1 not valid.
|
|
</dd>
|
|
<dt><b>TCP4994</b></dt>
|
|
<dd>CCSID parameter value &1 not found.
|
|
</dd>
|
|
<dt><b>TCP8050</b></dt>
|
|
<dd>*IOSYSCFG authority required to use &1.
|
|
</dd>
|
|
<dt><b>TCP9503</b></dt>
|
|
<dd>File &3 in library &2 not available.
|
|
</dd>
|
|
<dt><b>TCP9999</b></dt>
|
|
<dd>Internal system error in program &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSMTPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|