ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/chgtelna.htm

422 lines
18 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 TELNET Attributes (CHGTELNA)</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="CHGTELNA.Top_Of_Page"></a>
<h2>Change TELNET Attributes (CHGTELNA)</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="#CHGTELNA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGTELNA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGTELNA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGTELNA"></a>
<p>The Change TELNET Attributes (CHGTELNA) command is used to change configurable TELNET attributes. The changes take effect the next time the TELNET server is started either by the Start TCP/IP (STRTCP) command or by the Start TCP/IP Server (STRTCPSVR) command.
</p>
<p>
<b>Note: </b>The CHGTELNA command parameters are used by the TELNET server only; they are not used by the TELNET client. Many of these same parameters can be set for TELNET clients using the Start TCP/IP TELNET (STRTCPTELN) command or the TELNET client subcommands.
</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="#CHGTELNA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGTELNA.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="#CHGTELNA.AUTOSTART"><b>AUTOSTART</b></a></td>
<td valign="top">Autostart server</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="#CHGTELNA.NBRSVR"><b>NBRSVR</b></a></td>
<td valign="top">Number servers</td>
<td valign="top">1-200, <b><u>*SAME</u></b>, *CALC</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTELNA.TIMMRKTIMO"><b>TIMMRKTIMO</b></a></td>
<td valign="top">Session keep alive timeout</td>
<td valign="top">0-2147483647, <b><u>*SAME</u></b>, *CALC, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTELNA.DFTNVTTYPE"><b>DFTNVTTYPE</b></a></td>
<td valign="top">Default NVT type</td>
<td valign="top"><b><u>*SAME</u></b>, *VT100, *NVT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTELNA.CCSID"><b>CCSID</b></a></td>
<td valign="top">Coded character set identifier</td>
<td valign="top">1-65533, <b><u>*SAME</u></b>, *MULTINAT, *BRITISH, *DUTCH, *FINNISH, *FRENCH, *FRENCHCAN, *GERMAN, *ITALIAN, *NORDAN, *SPANISH, *SWEDISH, *SWISS</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CHGTELNA.TBLVTOUT"><b>TBLVTOUT</b></a></td>
<td valign="top">ASCII fullscreen mapping</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="#CHGTELNA.TBLVTIN"><b>TBLVTIN</b></a></td>
<td valign="top"> </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="#CHGTELNA.ALWSSL"><b>ALWSSL</b></a></td>
<td valign="top">Allow Secure Socket Layer</td>
<td valign="top">*YES, *NO, *ONLY, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGTELNA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGTELNA.AUTOSTART"></a>
<h3>Autostart server (AUTOSTART)</h3>
<p>Specifies whether to automatically start the TELNET server when TCP/IP is started by the STRTCP command or STRTCPSVR SERVER(*AUTOSTART) command. If STRTCPSVR *TELNET is specified and the TELNET servers are already running, no additional jobs are started.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The AUTOSTART value does not change if it was previously set. Otherwise, *YES is used.
</dd>
<dt><b>*YES</b></dt>
<dd>Automatically start the TELNET server.
</dd>
<dt><b>*NO</b></dt>
<dd>Do not automatically start the TELNET server.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTELNA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTELNA.NBRSVR"></a>
<h3>Number servers (NBRSVR)</h3>
<p>Specifies the number of servers to start. TELNET has two types of server jobs 1) TELNET Server jobs and 2) Device Manager jobs. This number indicates the number of jobs started for the device manager server. If the TELNET SSL was started successfully, the number also indicates the number of jobs started for the TELNET server job. If TELNET SSL was not started, there will be one TELNET Server job.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The number of servers value does not change if it was previously set. Otherwise, *CALC is used.
</dd>
<dt><b>*CALC</b></dt>
<dd>The number of Servers jobs and Device Manager jobs started will be determined by the system. For more information on how the *CALC value is calculated and considerations if you want to change this value, see the <u> TCP/IP Configuration and Reference</u> .
</dd>
<dt><b><i>1-200</i></b></dt>
<dd>Specify the number of servers to start. For example, if you specify 6 and TELNET SSL was started successfully, six TELNET Server jobs and six Device Manager jobs will be started. If TELNET SSL was not started successfully, one TELNET Server job will be started.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTELNA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTELNA.TIMMRKTIMO"></a>
<h3>Session keep alive timeout (TIMMRKTIMO)</h3>
<p>Specifies the number of seconds between connection validation. TCP tests each TELNET connection at the specified time interval. If TCP does not get a response, it ends the connection.
</p>
<p>This parameter determines how frequently the session connection is verified. A high value can result in a longer time before a lost connection gets detected. A lower value tests the session more frequently, but if set too low then normal network delays may result in connections being considered lost.
</p>
<p>An explanation of keep alive can be found in the help information for command CHGTCPA parameter TCPKEEPALV. Note that TCPKEEPALV is defined in minutes, while TIMMRKTIMO is defined in seconds.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The session keep alive value does not change if it was previously set. Otherwise, *CALC is used.
</dd>
<dt><b>*CALC</b></dt>
<dd>The session keep alive is based on the frequency of sampling.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default session keep alive value is set to 600 seconds.
</dd>
<dt><b><i>0-2147483647</i></b></dt>
<dd>Specify the number of seconds for the session keep alive timeout. A value of 0 means that there is no timeout.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTELNA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTELNA.DFTNVTTYPE"></a>
<h3>Default NVT type (DFTNVTTYPE)</h3>
<p>Specifies the default Network Virtual Terminal (NVT) type to be used when the TELNET server is not able to negotiate one of the supported types.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The default NVT type does not change if it was previously set. Otherwise, *VT100 is used.
</dd>
<dt><b>*VT100</b></dt>
<dd>The TELNET server defaults to VT100 mode when the server and client fail to negotiate one of the supported terminal types. The OS/400 server system operates as if the VT100 terminal type were negotiated.
</dd>
<dt><b>*NVT</b></dt>
<dd>The TELNET server defaults to the network virtual terminal (NVT) mode when the server and client fail to negotiate one of the supported terminal types. NVT mode requires an application program written to interact with NVT workstation devices.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTELNA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTELNA.CCSID"></a>
<h3>Coded character set identifier (CCSID)</h3>
<p>Specifies the ASCII coded character set identifier (CCSID) in use on the VTxxx terminal. CCSID is the default used by TELNET for ASCII full-screen mapping. The ASCII CCSID value is used to map between the EBCDIC CCSID of the job and the national replacement character set or the ASCII CCSID value selected with the CCSID parameter. This value is used by VTxxx users when they sign on the OS/400 system.
</p>
<p>Outgoing and incoming mapping can optionally be done with mapping tables defined in the TBLVTOUT and TBLVTIN parameters. Normally the TBLVTOUT and TBLVTIN parameters are set to the default of *CCSID or *DFT. Both parameters indicate that the value used in the CCSID parameter is used for mapping. If a mapping table is to be used for outgoing mapping, a table object can be specified in the TBLVTOUT parameter. The table object specified in the TBLVTOUT 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 TBLVTIN parameter. This mapping table overrides the specified CCSID value and is used for incoming mapping.
</p>
<p>The national replacement character set special values allowed for the CCSID parameter are the Digital Equipment Corporation (DEC) standard character sets. A numeric CCSID value can be used optionally to identify the required ASCII-to-EBCDIC and EBCDIC-to-ASCII mapping. If a numeric CCSID value is chosen, it is validated to ensure it is a valid ASCII CCSID value that is available on the current system.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The default CCSID value does not change if it was previously set. Otherwise, *MULTINAT is used.
</dd>
<dt><b>*MULTINAT</b></dt>
<dd>The DEC multinational character set is in use.
</dd>
<dt><b>*BRITISH</b></dt>
<dd>The DEC British national replacement character set is in use.
</dd>
<dt><b>*DUTCH</b></dt>
<dd>The DEC Dutch national replacement character set is in use.
</dd>
<dt><b>*FINNISH</b></dt>
<dd>The DEC Finnish national replacement character set is in use.
</dd>
<dt><b>*FRENCH</b></dt>
<dd>The DEC French national replacement character set is in use.
</dd>
<dt><b>*FRENCHCAN</b></dt>
<dd>The DEC French Canadian national replacement character set is in use.
</dd>
<dt><b>*GERMAN</b></dt>
<dd>The DEC German national replacement character set is in use.
</dd>
<dt><b>*ITALIAN</b></dt>
<dd>The DEC Italian national replacement character set is in use.
</dd>
<dt><b>*NORDAN</b></dt>
<dd>The DEC Norwegian/Danish national replacement character set is in use.
</dd>
<dt><b>*SPANISH</b></dt>
<dd>The DEC Spanish national replacement character set is in use.
</dd>
<dt><b>*SWEDISH</b></dt>
<dd>The DEC Swedish national replacement character set is in use.
</dd>
<dt><b>*SWISS</b></dt>
<dd>The DEC Swiss national replacement character set is in use.
</dd>
<dt><b><i>1-65533</i></b></dt>
<dd>The requested CCSID value is used. This value is validated to ensure a valid ASCII CCSID was requested.
<p>
<b>Note: </b>Only ISO 7-bit and ISO 8-bit ASCII CCSID values can be specified.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTELNA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTELNA.TBLVTOUT"></a>
<h3>Outgoing EBCDIC/ASCII table (TBLVTOUT)</h3>
<p>Specifies the outgoing mapping table used by the TELNET server to map outgoing data when in an ASCII full-screen session. All outgoing data is mapped from EBCDIC to ASCII.
</p>
<p>If a table object is specified for the TBLVTOUT parameter, the table object is used for outgoing mapping. Otherwise, the CCSID parameter is used for outgoing mapping.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The default TBLVTOUT 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. This mapping table is used instead of the default mapping specified by the CCSID parameter.
</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="#CHGTELNA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTELNA.TBLVTIN"></a>
<h3>Incoming ASCII/EBCDIC table (TBLVTIN)</h3>
<p>Specifies the incoming mapping table used by the TELNET server to map incoming data when in an ASCII full-screen session. All incoming data is mapped from ASCII to EBCDIC.
</p>
<p>If a table object is specified for the TBLVTIN parameter, the table object is used for incoming mapping. Otherwise, the CCSID parameter is used for incoming mapping.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The default TBLVTIN 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: Incoming ASCII/EBCDIC table</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the incoming mapping table. This mapping table is used instead of the default mapping specified by the CCSID parameter.
</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="#CHGTELNA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTELNA.ALWSSL"></a>
<h3>Allow Secure Socket Layer (ALWSSL)</h3>
<p>Specifies whether Secure Socket Layer and non Secure Socket Layer support should be started.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The Allow Secure Socket Layer setting is not changed if it was previously set. Otherwise, *YES is used.
</dd>
<dt><b>*YES</b></dt>
<dd>The Secure Socket Layer and non Secure Socket Layer support will be started.
</dd>
<dt><b>*NO</b></dt>
<dd>The non Secure Socket Layer support will be started.
</dd>
<dt><b>*ONLY</b></dt>
<dd>The Secure Socket Layer support will be started.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTELNA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGTELNA.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Setting the Session Keep Alive Timeout</b>
</p>
<p>
<pre>
CHGTELNA TIMMRKTIMO(600)
</pre>
</p>
<p>This command sets the session keep alive timeout to be 600 seconds. Each TELNET connection will be validated by TCP every 10 minutes. If TCP does not get a response, it ends the connection.
</p>
<p><b>Example 2: Setting the TELNET Autostart Attribute</b>
</p>
<p>
<pre>
CHGTELNA AUTOSTART(*NO)
</pre>
</p>
<p>This command sets the autostart attribute such that the TELNET server will not be started when TCP/IP is started by the STRTCP command or STRTCPSVR SERVER(*AUTOSTART) command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTELNA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGTELNA.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>TCP8050</b></dt>
<dd>*IOSYSCFG authority required to use &amp;1.
</dd>
<dt><b>TCP9999</b></dt>
<dd>Internal system error in program &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTELNA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>