friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/crtdevhost.htm

425 lines
16 KiB
HTML
Raw Blame History

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Create Device Desc (SNA Host) (CRTDEVHOST)</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="CRTDEVHOST.Top_Of_Page"></a>
<h2>Create Device Desc (SNA Host) (CRTDEVHOST)</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="#CRTDEVHOST.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTDEVHOST.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTDEVHOST.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTDEVHOST"></a>
<p>The Create Device Description (SNA Host) (CRTDEVHOST) command creates a device description for a Systems Network Architecture (SNA) host system device.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTDEVHOST.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="#CRTDEVHOST.DEVD"><b>DEVD</b></a></td>
<td valign="top">Device description</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVHOST.LOCADR"><b>LOCADR</b></a></td>
<td valign="top">Local location address</td>
<td valign="top">01-FF</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVHOST.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
<td valign="top">Remote location</td>
<td valign="top"><i>Communications name</i></td>
<td valign="top">Required, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVHOST.ONLINE"><b>ONLINE</b></a></td>
<td valign="top">Online at IPL</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVHOST.CTL"><b>CTL</b></a></td>
<td valign="top">Attached controller</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVHOST.APPTYPE"><b>APPTYPE</b></a></td>
<td valign="top">Application type</td>
<td valign="top"><b><u>*RJE</u></b>, *EML, *PGM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVHOST.MAXLENRU"><b>MAXLENRU</b></a></td>
<td valign="top">Maximum length of request unit</td>
<td valign="top"><b><u>*CALC</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="#CRTDEVHOST.EMLDEV"><b>EMLDEV</b></a></td>
<td valign="top">Emulated device</td>
<td valign="top"><b><u>3278</u></b>, 3284, 3286, 3287, 3288, 3289</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVHOST.EMLKBD"><b>EMLKBD</b></a></td>
<td valign="top">Emulated keyboard</td>
<td valign="top"><b><u>*UPPER</u></b>, *LOWER</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVHOST.EMLNUMLCK"><b>EMLNUMLCK</b></a></td>
<td valign="top">Emulated numeric lock</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVHOST.EMLWRKSTN"><b>EMLWRKSTN</b></a></td>
<td valign="top">Emulation work station</td>
<td valign="top"><i>Name</i>, <b><u>*ANY</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVHOST.ENDSSNHOST"><b>ENDSSNHOST</b></a></td>
<td valign="top">End session with host</td>
<td valign="top"><b><u>*UNBIND</u></b>, *RSHUTD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVHOST.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVHOST.DEPLOCNAME"><b>DEPLOCNAME</b></a></td>
<td valign="top">Dependent location name</td>
<td valign="top"><i>Communications name</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVHOST.AUT"><b>AUT</b></a></td>
<td valign="top">Authority</td>
<td valign="top"><i>Name</i>, <b><u>*CHANGE</u></b>, *ALL, *USE, *EXCLUDE, *LIBCRTAUT</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTDEVHOST.DEVD"></a>
<h3>Device description (DEVD)</h3>
<p>Specifies the name of the device description.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVHOST.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>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVHOST.RMTLOCNAME"></a>
<h3>Remote location (RMTLOCNAME)</h3>
<p>Specifies the name of the remote location with which your program communicates.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVHOST.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>*YES</u></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="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVHOST.CTL"></a>
<h3>Attached controller (CTL)</h3>
<p>Specifies the name of the controller description to which this device is attached.
</p>
<p>
<b>Note: </b>To use this device for communicating with a remote location that resides on the same system as the local location, specify a controller description that was created with LINKTYPE (*LOCAL) specified.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVHOST.APPTYPE"></a>
<h3>Application type (APPTYPE)</h3>
<p>Specifies what application type is used by this device.
</p>
<dl>
<dt><b>*RJE</b></dt>
<dd>This device is used by Remote Job Entry (RJE).
</dd>
<dt><b>*EML</b></dt>
<dd>This device is used by 3270 Device Emulation.
</dd>
<dt><b>*PGM</b></dt>
<dd>This device is used for program-to-program communications.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVHOST.MAXLENRU"></a>
<h3>Maximum length of request unit (MAXLENRU)</h3>
<p>Specifies the maximum request unit (RU) length allowed.
</p>
<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="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVHOST.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>3278</u></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="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVHOST.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>*UPPER</u></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="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVHOST.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>*NO</u></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="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVHOST.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>*ANY</u></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="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVHOST.ENDSSNHOST"></a>
<h3>End session with host (ENDSSNHOST)</h3>
<p>Specifies how the host device ends a session with the host system.
</p>
<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="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVHOST.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the object.
</p>
<dl>
<dt><b>*BLANK</b></dt>
<dd>No text is specified.
</dd>
<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="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVHOST.DEPLOCNAME"></a>
<h3>Dependent location name (DEPLOCNAME)</h3>
<p>Specifies the dependent local location name used for Dependent LU Requester (DLUR), providing additional security for the connection. If this name is filled in, an activation request (SNA ACTLU) from a Dependent LU Server (DLUS) node must reference this name or it is rejected.
</p>
<p>Remote DLUS nodes may optionally accept unsolicited reply PSIDs (Product Set IDs) from the iSeries for auto-definition of LUs at the DLUS node. If so, then this name will be sent to the DLUS node in the reply PSID and it will be returned on the ACTLU request.
</p>
<p>If unsolicited reply PSIDs are not supported by the DLUS node, then there will have to be close coordination of the PU name definitions on both systems.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No location name is defined.
</dd>
<dt><b><i>dependent-location-name</i></b></dt>
<dd>Specify the dependent location name used for DLUR applications.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVHOST.AUT"></a>
<h3>Authority (AUT)</h3>
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
</p>
<dl>
<dt><b><u>*CHANGE</u></b></dt>
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
</dd>
</dl>
<dl>
<dt><b>*ALL</b></dt>
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
</dd>
</dl>
<dl>
<dt><b>*USE</b></dt>
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
</dd>
</dl>
<dl>
<dt><b>*EXCLUDE</b></dt>
<dd>The user cannot access the object.
</dd>
</dl>
<dl>
<dt><b>*LIBCRTAUT</b></dt>
<dd>The system determines the authority for the object by using the value specified for the <b>Create authority (CRTAUT)</b> parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTDEVHOST.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CRTDEVHOST DEVD(COMMDSP1) LOCADR(FE)
RMTLOCNAME(SYS) CTL(HOSTCTL001)
APPTYPE(*EML) EMLDEV(3284)
</pre>
</p>
<p>This command creates a device description for an SNA host communications device named COMMDSP1. The address of the device is X'FE'. It is attached to the controller HOSTCTL001 and communicates with SYS. This device uses 3270 emulation to emulate a 3284 printer.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTDEVHOST.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF261A</b></dt>
<dd>Device description &amp;1 not created due to errors.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVHOST.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink