362 lines
12 KiB
HTML
362 lines
12 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 POP Server Attributes (CHGPOPA)</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="CHGPOPA.Top_Of_Page"></a>
|
|
<h2>Change POP Server Attributes (CHGPOPA)</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="#CHGPOPA.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGPOPA.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGPOPA.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGPOPA"></a>
|
|
<p>The Change POP Mail Server Attributes (CHGPOPA) command is used to change the Post Office Protocol (POP) Version 3 Mail Server attributes. The changes take effect the next time the POP3 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="#CHGPOPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGPOPA.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="#CHGPOPA.AUTOSTART"><b>AUTOSTART</b></a></td>
|
|
<td valign="top">Autostart servers</td>
|
|
<td valign="top">*YES, *NO, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGPOPA.NBRSVR"><b>NBRSVR</b></a></td>
|
|
<td valign="top">Number of initial servers</td>
|
|
<td valign="top">1-20, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGPOPA.INACTTIMO"><b>INACTTIMO</b></a></td>
|
|
<td valign="top">Inactivity timeout</td>
|
|
<td valign="top">10-65535, <b><u>*SAME</u></b>, *DFT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGPOPA.MSGSPLIT"><b>MSGSPLIT</b></a></td>
|
|
<td valign="top">Message split size</td>
|
|
<td valign="top">32-2048, <b><u>*SAME</u></b>, *DFT, *NOMAX</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGPOPA.MIMECCSID"><b>MIMECCSID</b></a></td>
|
|
<td valign="top">MIME CCSID</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Coded character set identifier</td>
|
|
<td valign="top">
|
|
<b><u>*SAME</u></b>, *DFT, 819, 912, 915, 1089, 813, 916, 920, 5052, 367, 923</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: When to use</td>
|
|
<td valign="top">
|
|
<b><u>*SAME</u></b>, *BESTFIT, *ALWAYS</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPOPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGPOPA.AUTOSTART"></a>
|
|
<h3>Autostart servers (AUTOSTART)</h3>
|
|
<p>Specifies whether to automatically start the POP mail server 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 the POP mail server is started by running the STRTCPSVR command, and SERVER(*AUTOSTART) is not specified, this parameter is ignored and the POP mail server is started regardless of the value of this parameter. If STRTCPSVR *POP is specified, and the POP server is already running, then an additional server job is started.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The AUTOSTART value does not change if it was previously set. Otherwise, *NO is used.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Do not automatically start any POP mail server jobs. If you do not intend to use the POP mail server, set AUTOSTART to *NO.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Start the number of server jobs specified for the <b>Number of initial servers (NBRSVR)</b> parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPOPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGPOPA.NBRSVR"></a>
|
|
<h3>Number of initial servers (NBRSVR)</h3>
|
|
<p>Specifies the number of POP mail server jobs to start when POP is started by either the Start TCP/IP (STRTCP) command or the Start TCP/IP Server (STRTCPSVR) command. These jobs allow new clients to connect to the server without having to wait for the overhead associated with starting a new job. The server tries to keep at least this number of jobs available for connecting to new clients as the number of connected clients changes. This is a performance enhancement for the POP mail server that reduces the system overhead each time a client connects.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The number of server jobs does not change if it was previously set; otherwise 3 is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The number of server jobs is set to the default value of 3.
|
|
</dd>
|
|
<dt><b><i>1-20</i></b></dt>
|
|
<dd>Specify the number of server jobs to start.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPOPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGPOPA.INACTTIMO"></a>
|
|
<h3>Inactivity timeout (INACTTIMO)</h3>
|
|
<p>Specifies the number of seconds of inactivity between the client and server before the server assumes the client has stopped communicating and disconnects from the client. When this event occurs the server does not delete any mail in the user's mail box to ensure that mail is not lost.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The inactivity timeout value does not change if it was previously set; otherwise 600 seconds (10 minutes) is used.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The inactivity timeout value is set to the default value of 600 seconds (10 minutes).
|
|
</dd>
|
|
<dt><b><i>10-65535</i></b></dt>
|
|
<dd>Specify the number of seconds to use for the inactivity timeout value.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPOPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGPOPA.MSGSPLIT"></a>
|
|
<h3>Message split size (MSGSPLIT)</h3>
|
|
<p>Specifies the number of kilobytes that will be used for partial message blocks when the mail message exceeds this count. This is used only for remote mail delivery. This is a network parameter and is determined by the capacities of the network gateways you are connected to. Changes to this parameter take effect immediately; you do not need to restart the POP server.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change if it was previously set; otherwise *NOMAX is used.
|
|
</dd>
|
|
<dt><b>*NOMAX</b></dt>
|
|
<dd>Disables message splitting, data is sent as one message.
|
|
</dd>
|
|
<dt><b>*DFT</b></dt>
|
|
<dd>The message split size is set to the default value of *NOMAX.
|
|
</dd>
|
|
<dt><b><i>32-2048</i></b></dt>
|
|
<dd>Specify the number of kilobytes to use for the message split size.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPOPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGPOPA.MIMECCSID"></a>
|
|
<h3>MIME CCSID (MIMECCSID)</h3>
|
|
<p>Specifies the MIME coded-character set identifier (CCSID) conversion parameters for text data. You must restart the mail server framework (using the STRMSF command) for changes to this parameter to take effect.
|
|
</p>
|
|
<p><b>Element 1: Coded character set identifier</b>
|
|
</p>
|
|
<p>CCSID value to be used for single-byte character set (SBCS) and some mixed-byte character set (MBCS) ASCII translations when doing ASCII-to-EBCDIC and EBCDIC-to-ASCII mapping.
|
|
</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><i>CCSID-value</i></b></dt>
|
|
<dd>Specify an ASCII CCSID value from the following list. This value is validated to ensure that you are specifying a valid MIME Standard ASCII CCSID.
|
|
<dl>
|
|
<dt><b>00367</b></dt>
|
|
<dd>
|
|
<p>
|
|
<pre>
|
|
MIME Standard: US-ASCII
|
|
Name: US English
|
|
EBCDIC CCSID: 00500
|
|
</pre>
|
|
</p>
|
|
</dd>
|
|
<dt><b>00819</b></dt>
|
|
<dd>
|
|
<p>
|
|
<pre>
|
|
MIME Standard: ISO-8859-1
|
|
Name: Latin-1
|
|
EBCDIC CCSID: 00500
|
|
</pre>
|
|
</p>
|
|
</dd>
|
|
<dt><b>00912</b></dt>
|
|
<dd>
|
|
<p>
|
|
<pre>
|
|
MIME Standard: ISO-8859-2
|
|
Name: Latin-2
|
|
EBCDIC CCSID: 870
|
|
</pre>
|
|
</p>
|
|
</dd>
|
|
<dt><b>00915</b></dt>
|
|
<dd>
|
|
<p>
|
|
<pre>
|
|
MIME Standard: ISO-8859-5
|
|
Name: Cyrillic
|
|
EBCDIC CCSID: 01025
|
|
</pre>
|
|
</p>
|
|
</dd>
|
|
<dt><b>01089</b></dt>
|
|
<dd>
|
|
<p>
|
|
<pre>
|
|
MIME Standard: ISO-8859-6
|
|
Name: Arabic
|
|
EBCDIC CCSID: 00420
|
|
</pre>
|
|
</p>
|
|
</dd>
|
|
<dt><b>00813</b></dt>
|
|
<dd>
|
|
<p>
|
|
<pre>
|
|
MIME Standard: ISO-8859-7
|
|
Name: Greek
|
|
EBCDIC CCSID: 00875
|
|
</pre>
|
|
</p>
|
|
</dd>
|
|
<dt><b>00916</b></dt>
|
|
<dd>
|
|
<p>
|
|
<pre>
|
|
MIME Standard: ISO-8859-8
|
|
Name: Hebrew
|
|
EBCDIC CCSID: 00424
|
|
</pre>
|
|
</p>
|
|
</dd>
|
|
<dt><b>00920</b></dt>
|
|
<dd>
|
|
<p>
|
|
<pre>
|
|
MIME Standard: ISO-8859-9
|
|
Name: Latin-5
|
|
EBCDIC CCSID: 01026
|
|
</pre>
|
|
</p>
|
|
</dd>
|
|
<dt><b>00923</b></dt>
|
|
<dd>
|
|
<p>
|
|
<pre>
|
|
MIME Standard: ISO-8859-15
|
|
Name: Latin-9
|
|
EBCDIC CCSIDs: 01140-1149
|
|
</pre>
|
|
</p>
|
|
</dd>
|
|
<dt><b>05052</b></dt>
|
|
<dd>
|
|
<p>
|
|
<pre>
|
|
MIME Standard: ISO-2022-JP
|
|
Name: Japan MBCS
|
|
EBCDIC CCSID: 05026
|
|
</pre>
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: When to use</b>
|
|
</p>
|
|
<p>Specifies whether or not to force conversion of mail to or from the ASCII CCSID specified on the CCSID parameter. This configured parameter is a global parameter; once you set it to *ALWAYS, it dictates the CCSID that all EBCDIC-to-ASCII mail will use. This parameter should only be set to *ALWAYS if there is a requirement to limit the character set. This should be communicated to all clients requiring mail interchange, particularly where language differences could cause a loss of certain language-specific symbols.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The attribute does not change if it was previously set; otherwise *BESTFIT is used.
|
|
</dd>
|
|
<dt><b>*BESTFIT</b></dt>
|
|
<dd>Use the specified CCSID <i>only if</i> the Mail Server Framework is unable to determine the CCSID from the data in the mail.
|
|
</dd>
|
|
<dt><b>*ALWAYS</b></dt>
|
|
<dd>Always use the specified CCSID, even if the Mail Server Framework would have used a best-fit CCSID. For incoming mail, the specified CCSID is used if the MIME character set is not supported by the Mail Server Framework. For outgoing mail, EBCDIC-to-ASCII will always convert to the specified CCSID.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPOPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGPOPA.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Setting an Inactivity Timeout</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGPOPA INACTTIMO(700)
|
|
</pre>
|
|
</p>
|
|
<p>This command sets the time of 700 seconds that the POP server will wait before assuming the client has stopped communicating. After this time the server will disconnect from the client. No mail will be deleted.
|
|
</p>
|
|
<p><b>Example 2: Setting a Default CCSID</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGPOPA MIMECCSID(923 *BESTFIT)
|
|
</pre>
|
|
</p>
|
|
<p>This command sets the CCSID 923 to be used for conversions, if the CCSID cannot be determined from the mail. This CCSID contains the Euro character.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPOPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGPOPA.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<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>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPOPA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|