340 lines
12 KiB
HTML
340 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 Device Desc (SNA Host) (CHGDEVHOST)</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="CHGDEVHOST.Top_Of_Page"></a>
|
||
|
|
<h2>Change Device Desc (SNA Host) (CHGDEVHOST)</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="#CHGDEVHOST.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CHGDEVHOST.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CHGDEVHOST.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CHGDEVHOST"></a>
|
||
|
|
<p>The Change Device Description (SNA Host) (CHGDEVHOST) command changes a device description for a Systems Network Architecture (SNA) host system device.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGDEVHOST.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CHGDEVHOST.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="#CHGDEVHOST.DEVD"><b>DEVD</b></a></td>
|
||
|
|
<td valign="top">Device description</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Required, Key, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGDEVHOST.LOCADR"><b>LOCADR</b></a></td>
|
||
|
|
<td valign="top">Local location address</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, 01, 02, 03, 04, 05, 06, 07, 08, 09, 0A, 0B, 0C, 0D, 0E, 0F, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 1A, 1B, 1C, 1D, 1E, 1F, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 2A, 2B, 2C, 2D, 2E, 2F, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 3A, 3B, 3C, 3D, 3E, 3F, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 4A, 4B, 4C, 4D, 4E, 4F, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 5A, 5B, 5C, 5D, 5E, 5F, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 6A, 6B, 6C, 6D, 6E, 6F, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 7A, 7B, 7C, 7D, 7E, 7F, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 8A, 8B, 8C, 8D, 8E, 8F, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 9A, 9B, 9C, 9D, 9E, 9F, A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, AA, AB, AC, AD, AE, AF, B0, B1, B2, B3, B4, B5, B6, B7, B8, B9, BA, BB, BC, BD, BE, BF, C0, C1, C2, C3, C4, C5, C6, C7, C8, C9, CA, CB, CC, CD, CE, CF, D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, DA, DB, DC, DD, DE, DF, E0, E1, E2, E3, E4, E5, E6, E7, E8, E9, EA, EB, EC, ED, EE, EF, F0, F1, F2, F3, F4, F5, F6, F7, F8, F9, FA, FB, FC, FD, FE, FF</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGDEVHOST.ONLINE"><b>ONLINE</b></a></td>
|
||
|
|
<td valign="top">Online at IPL</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGDEVHOST.MAXLENRU"><b>MAXLENRU</b></a></td>
|
||
|
|
<td valign="top">Maximum length of request unit</td>
|
||
|
|
<td valign="top">*CALC, <b><u>*SAME</u></b>, 241, 245, 247, 256, 497, 501, 503, 512, 768, 1009, 1015, 1024, 1280, 1536, 1792, 2048, 2304, 2560, 2816, 3072, 3328, 3584, 3840, 4096</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGDEVHOST.EMLDEV"><b>EMLDEV</b></a></td>
|
||
|
|
<td valign="top">Emulated device</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, 3278, 3284, 3286, 3287, 3288, 3289</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGDEVHOST.EMLKBD"><b>EMLKBD</b></a></td>
|
||
|
|
<td valign="top">Emulated keyboard</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *UPPER, *LOWER</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGDEVHOST.EMLNUMLCK"><b>EMLNUMLCK</b></a></td>
|
||
|
|
<td valign="top">Emulated numeric lock</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGDEVHOST.EMLWRKSTN"><b>EMLWRKSTN</b></a></td>
|
||
|
|
<td valign="top">Emulation work station</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *ANY</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGDEVHOST.ENDSSNHOST"><b>ENDSSNHOST</b></a></td>
|
||
|
|
<td valign="top">End session with host</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *UNBIND, *RSHUTD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGDEVHOST.TEXT"><b>TEXT</b></a></td>
|
||
|
|
<td valign="top">Text 'description'</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGDEVHOST.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CHGDEVHOST.DEVD"></a>
|
||
|
|
<h3>Device description (DEVD)</h3>
|
||
|
|
<p>Specifies the name of the device description being changed.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGDEVHOST.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGDEVHOST.LOCADR"></a>
|
||
|
|
<h3>Local location address (LOCADR)</h3>
|
||
|
|
<p>Specifies the local location address for this device.
|
||
|
|
</p>
|
||
|
|
<p>Valid values range from 01 to FF.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGDEVHOST.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGDEVHOST.ONLINE"></a>
|
||
|
|
<h3>Online at IPL (ONLINE)</h3>
|
||
|
|
<p>Specifies whether this object is automatically varied on at initial program load (IPL).
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>This device is varied on automatically at IPL.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>This device is not varied on automatically at IPL.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGDEVHOST.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGDEVHOST.MAXLENRU"></a>
|
||
|
|
<h3>Maximum length of request unit (MAXLENRU)</h3>
|
||
|
|
<p>Specifies the maximum request unit (RU) length allowed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*CALC</b></dt>
|
||
|
|
<dd>The system determines the best value to use. This is the recommended value.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>maximum-length-request-unit</i></b></dt>
|
||
|
|
<dd>Specify a value, 256 through 4096, in amounts of 256, to be used as the maximum length for incoming request units. Values 241, 247, 497, 503, 1009, and 1015 can also be specified but are valid only if the device is attached to an X.25 network.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGDEVHOST.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGDEVHOST.EMLDEV"></a>
|
||
|
|
<h3>Emulated device (EMLDEV)</h3>
|
||
|
|
<p>Specifies that this program device entry is used to send and receive 3270 data streams. The emulation device parameter consists of an emulation device type and an emulation device data format. The emulation device data format specifies the format of the type 3270 data stream being sent or received. A 20- or 32-byte common header that contains type 3270 command and data flow information is located at the start of the I/O buffer that is sending or receiving the type 3270 data stream. This parameter applies only to SNUF communications. This parameter can be specified as a list of two values (elements) or as a single value (*NONE).
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>3278</b></dt>
|
||
|
|
<dd>This device is used to emulate a 3278 display device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>3284</b></dt>
|
||
|
|
<dd>This device is used to emulate a 3284 printer device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>3286</b></dt>
|
||
|
|
<dd>This device is used to emulate a 3286 printer device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>3287</b></dt>
|
||
|
|
<dd>This device is used to emulate a 3287 printer device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>3288</b></dt>
|
||
|
|
<dd>This device is used to emulate a 3288 printer device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>3289</b></dt>
|
||
|
|
<dd>This device is used to emulate a 3289 printer device.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGDEVHOST.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGDEVHOST.EMLKBD"></a>
|
||
|
|
<h3>Emulated keyboard (EMLKBD)</h3>
|
||
|
|
<p>Specifies the type of 3278 display keyboard that is emulated. This parameter is valid only when *EML is specified for the <b>Application type (APPTYPE)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*UPPER</b></dt>
|
||
|
|
<dd>A 3270 display device keyboard is emulated with uppercase characters only.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LOWER</b></dt>
|
||
|
|
<dd>A 3270 display device keyboard is emulated with uppercase and lowercase characters.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGDEVHOST.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGDEVHOST.EMLNUMLCK"></a>
|
||
|
|
<h3>Emulated numeric lock (EMLNUMLCK)</h3>
|
||
|
|
<p>Specifies whether numeric input fields only allow numeric data on a 5250 keyboard. The value can be specified for this parameter only if *EML is specified for the <b>Application type (APPTYPE)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>3270 emulation allows any data to be typed in the numeric input fields.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>3270 emulation allows only numeric data to be typed in the numeric input fields. Valid numeric data include the characters 0 through 9 and symbols + - , . and blank.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGDEVHOST.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGDEVHOST.EMLWRKSTN"></a>
|
||
|
|
<h3>Emulation work station (EMLWRKSTN)</h3>
|
||
|
|
<p>The emulation work station associates an emulation device with a real display or printer device. The device address is reserved for use exclusively by that work station. If no device or *ANY is specified, any work station can use the emulation device.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ANY</b></dt>
|
||
|
|
<dd>Any work station can use the emulation device.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>work-station</i></b></dt>
|
||
|
|
<dd>Specify the name for the work station that is to use this emulation device.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGDEVHOST.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGDEVHOST.ENDSSNHOST"></a>
|
||
|
|
<h3>End session with host (ENDSSNHOST)</h3>
|
||
|
|
<p>Specifies how the host device ends a session with the host system. The ENDSSNHOST parameter can be changed at any time and takes effect immediately after the change occurs.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*UNBIND</b></dt>
|
||
|
|
<dd>The host device sends the SNA command requesting the iSeries system to end the session.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RSHUTD</b></dt>
|
||
|
|
<dd>The host device sends the SNA command requesting the host system to end the session.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGDEVHOST.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGDEVHOST.TEXT"></a>
|
||
|
|
<h3>Text 'description' (TEXT)</h3>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The text (if any) does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*BLANK</b></dt>
|
||
|
|
<dd>No text is specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGDEVHOST.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGDEVHOST.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGDEVHOST DEVD(COMMDSP1) EMLDEV(3286)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes the device description named COMMDSP1 so it emulates a 3286 printer.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGDEVHOST.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGDEVHOST.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF2618</b></dt>
|
||
|
|
<dd>Device description &1 not changed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGDEVHOST.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|