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

261 lines
9.7 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>Set VT Mapping Tables (SETVTTBL)</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="SETVTTBL.Top_Of_Page"></a>
<h2>Set VT Mapping Tables (SETVTTBL)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#SETVTTBL.PARAMETERS.TABLE">Parameters</a><br>
<a href="#SETVTTBL.COMMAND.EXAMPLES">Examples</a><br>
<a href="#SETVTTBL.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="SETVTTBL"></a>
<p>The Set VT Mapping Tables (SETVTTBL) command sets ASCII full-screen mapping for the current TELNET session.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETVTTBL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SETVTTBL.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="#SETVTTBL.CCSID"><b>CCSID</b></a></td>
<td valign="top">Coded character set identifier</td>
<td valign="top">1-65533, <b><u>*MULTINAT</u></b>, *BRITISH, *DUTCH, *FINNISH, *FRENCH, *FRENCHCAN, *GERMAN, *ITALIAN, *NORDAN, *SPANISH, *SWEDISH, *SWISS</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#SETVTTBL.TBLVTOUT"><b>TBLVTOUT</b></a></td>
<td valign="top">Outgoing EBCDIC/ASCII table</td>
<td valign="top">Single values: <b><u>*CCSID</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: Outgoing EBCDIC/ASCII table</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, *LIBL, *CURLIB</td>
</tr><tr>
<td valign="top" rowspan="3"><a href="#SETVTTBL.TBLVTIN"><b>TBLVTIN</b></a></td>
<td valign="top">Incoming ASCII/EBCDIC table</td>
<td valign="top">Single values: <b><u>*CCSID</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: Incoming ASCII/EBCDIC table</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, *LIBL, *CURLIB</td>
</tr></table>
<table width="100%">
<tr><td align="right"><a href="#SETVTTBL.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="SETVTTBL.CCSID"></a>
<h3>Coded character set identifier (CCSID)</h3>
<p>Specifies the coded character set identifier that identifies the ASCII character encoding in use on the VT100 or VT220 terminal.
</p>
<p>Use the CCSID value to change the default mapping for your <u> current</u> TELNET session only. Mapping can optionally be done with mapping tables defined in the TBLVTOUT and TBLVTIN parameters. The TBLVTOUT and TBLVTIN parameters have a default value of *CCSID. The default value of *CCSID indicates mapping is determined by the CCSID parameter. 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 by specifying a table object in the TBLVTIN parameter. This mapping table overrides the specified CCSID value and is used for incoming mapping.
</p>
<dl>
<dt><b><u>*MULTINAT</u></b></dt>
<dd>The Digital Equipment Company (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="#SETVTTBL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SETVTTBL.TBLVTOUT"></a>
<h3>Outgoing EBCDIC/ASCII table (TBLVTOUT)</h3>
<p>Specifies the table object that is to be used to map outgoing TELNET data when in VT100 or VT220 full-screen mode. All outgoing data is mapped from EBCDIC to ASCII.
</p>
<p>If a table object is specified for TBLVTOUT, 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>*CCSID</u></b></dt>
<dd>The table object to be used is determined by using the CCSID parameter and the current language of the user.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default EBCDIC-to-ASCII mapping is used. The value specified for the TBLVTOUT parameter of the Change TELNET Attributes (CHGTELNA) command is used here.
</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 table object used for mapping outgoing TELNET data.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b>*LIBL</b></dt>
<dd>The library list is used to locate the outgoing mapping table.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the outgoing mapping table. 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 where the outgoing mapping table is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETVTTBL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SETVTTBL.TBLVTIN"></a>
<h3>Incoming ASCII/EBCDIC table (TBLVTIN)</h3>
<p>Specifies the table object used to map all incoming TELNET data when in VT100 or VT220 full-screen mode. All incoming data is mapped from ASCII to EBCDIC.
</p>
<p>If a table object is specified for TBLVTIN, the table object is used for incoming mapping. Otherwise, the CCSID parameter is used to determine incoming mapping.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*CCSID</u></b></dt>
<dd>The table object to be used is determined by using the CCSID parameter and the current language of the user.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default ASCII-to-EBCDIC mapping table is used. The value specified for the TBLVTIN parameter of the Change TELNET Attributes (CHGTELNA) command is used here.
</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 table object used for mapping incoming TELNET data.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b>*LIBL</b></dt>
<dd>The library list is used to locate the incoming mapping table.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the incoming mapping table. 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 where the incoming table is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETVTTBL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SETVTTBL.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
SETVTTBL TBLVTOUT(*DFT) TBLVTIN(*DFT)
</pre>
</p>
<p>This command sets the EBCDIC-to-ASCII and ASCII-to-EBCDIC mapping tables to the values currently specified for the TBLVTOUT and TBLVTIN parameters of the Change TELNET Attributes (CHGTELNA) command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETVTTBL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SETVTTBL.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF9801</b></dt>
<dd>Object &amp;2 in library &amp;3 not found.
</dd>
<dt><b>CPF9802</b></dt>
<dd>Not authorized to object &amp;2 in &amp;3.
</dd>
<dt><b>CPF9803</b></dt>
<dd>Cannot allocate object &amp;2 in library &amp;3.
</dd>
<dt><b>CPF9808</b></dt>
<dd>Cannot allocate one or more libraries on library list.
</dd>
<dt><b>CPF9810</b></dt>
<dd>Library &amp;1 not found.
</dd>
<dt><b>CPF9820</b></dt>
<dd>Not authorized to use library &amp;1.
</dd>
<dt><b>CPF9830</b></dt>
<dd>Cannot assign library &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETVTTBL.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>