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

618 lines
24 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!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 (BSC) (CRTDEVBSC)</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="CRTDEVBSC.Top_Of_Page"></a>
<h2>Create Device Desc (BSC) (CRTDEVBSC)</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="#CRTDEVBSC.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTDEVBSC.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTDEVBSC.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTDEVBSC"></a>
<p>The Create Device Description (BSC) (CRTDEVBSC) command creates a device description for a binary synchronous communications (BSC) device.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTDEVBSC.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="#CRTDEVBSC.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="#CRTDEVBSC.LOCADR"><b>LOCADR</b></a></td>
<td valign="top">Local location address</td>
<td valign="top">00-FE</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVBSC.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="#CRTDEVBSC.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="#CRTDEVBSC.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="#CRTDEVBSC.CNN"><b>CNN</b></a></td>
<td valign="top">Connection type</td>
<td valign="top"><b><u>*PP</u></b>, *MPTRIB</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVBSC.APPTYPE"><b>APPTYPE</b></a></td>
<td valign="top">Application type</td>
<td valign="top"><b><u>*BSCEL</u></b>, *RJE, *EML, *BSC38, *RPGT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVBSC.CTNWIN"><b>CTNWIN</b></a></td>
<td valign="top">Contention resolution winner</td>
<td valign="top"><b><u>*SEC</u></b>, *PRI</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVBSC.BLOCK"><b>BLOCK</b></a></td>
<td valign="top">Blocking type</td>
<td valign="top"><b><u>*NONE</u></b>, *ITB, *IRS, *NOSEP, *USER, *SEP</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVBSC.SEPCHAR"><b>SEPCHAR</b></a></td>
<td valign="top">Separator character</td>
<td valign="top">00, 04, 05, 06, 07, 08, 09, 0A, 0B, 0C, 0D, 0E, 0F, 11, 12, 13, 14, 15, 16, 17, 18, 19, 1A, 1B, 1C, <b><u>1E</u></b>, 20, 21, 22, 23, 24, 25, 27, 28, 29, 2A, 2B, 2C, 2E, 2F, 30, 31, 33, 34, 35, 36, 38, 39, 3A, 3B, 3C, 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="#CRTDEVBSC.RMTBSCEL"><b>RMTBSCEL</b></a></td>
<td valign="top">Remote BSCEL</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVBSC.RCDLEN"><b>RCDLEN</b></a></td>
<td valign="top">Record length</td>
<td valign="top">1-8192, <b><u>512</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVBSC.BLKLEN"><b>BLKLEN</b></a></td>
<td valign="top">Block length</td>
<td valign="top">1-8192, <b><u>512</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVBSC.TRNSPY"><b>TRNSPY</b></a></td>
<td valign="top">Transmit in transparent mode</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVBSC.DTACPR"><b>DTACPR</b></a></td>
<td valign="top">Compress and decompress data</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVBSC.TRUNC"><b>TRUNC</b></a></td>
<td valign="top">Truncate trailing blanks</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVBSC.GRPSEP"><b>GRPSEP</b></a></td>
<td valign="top">Group separator type</td>
<td valign="top"><b><u>*EOT</u></b>, *OFCSYS, *DEV3740</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTDEVBSC.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="#CRTDEVBSC.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="#CRTDEVBSC.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="#CRTDEVBSC.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="#CRTDEVBSC.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="#CRTDEVBSC.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="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTDEVBSC.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="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.LOCADR"></a>
<h3>Local location address (LOCADR)</h3>
<p>Specifies the local location address for this device.
</p>
<p>Valid values range from 00 to FE.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.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="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.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="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.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="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.CNN"></a>
<h3>Connection type (CNN)</h3>
<p>Specifies the connection type for this device.
</p>
<dl>
<dt><b>*PP</b></dt>
<dd>A point-to-point connection type is used.
</dd>
<dt><b>*MPTRIB</b></dt>
<dd>A multipoint tributary connection type is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.APPTYPE"></a>
<h3>Application type (APPTYPE)</h3>
<p>Specifies the application type used by this device.
</p>
<dl>
<dt><b>*BSCEL</b></dt>
<dd>The application is Binary Synchronous Communications Equivalence Link (BSCEL). This parameter is specified to communicate with other BSC systems or devices supported by this system.
</dd>
<dt><b>*RJE</b></dt>
<dd>The application is BSC Remote Job Entry (RJE).
</dd>
<dt><b>*EML</b></dt>
<dd>The application is 3270 device emulation, using the 3270 Device Emulation Utility, or the 3270 program interface support provided in the System/38 environment.
</dd>
<dt><b>*BSC38</b></dt>
<dd>The application is a System/38 environment program. This parameter is specified for a device that communicates with other BSC systems or devices when the application uses a BSC device file or Mixed device file which is used in the System/38 environment.
</dd>
<dt><b>*RPGT</b></dt>
<dd>This parameter is specified for applications using RPG II Telecommunications (BSCA) in the System/36 environment.
<p>
<b>Note: </b>This value can also be specified when the application uses ICF support, but does not need Evoke capability or program-start request capability. If this value is specified, the value of the <b>Remote BSCEL (RMTBSCEL)</b> parameter is automatically set to *NO. If the application uses ICF, make sure there is no requirement for Evoke or program-start request support before you try to use this value, or unpredictable results will occur.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.CTNWIN"></a>
<h3>Contention resolution winner (CTNWIN)</h3>
<p>Specifies which BSC station will gain control when line contention occurs.
</p>
<dl>
<dt><b><u>*SEC</u></b></dt>
<dd>Specifies that the local system is the secondary station. It will give way to the other station when line contention occurs.
</dd>
<dt><b>*PRI</b></dt>
<dd>Specifies that the local system is the primary station. It gets control when contention occurs.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.BLOCK"></a>
<h3>Blocking type (BLOCK)</h3>
<p>Specifies if the system or user blocks and deblocks transmitted records.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No blocking or deblocking is done by the system.
</dd>
<dt><b>*ITB</b></dt>
<dd>Records are blocked or deblocked based on the location of an intermediate text block (ITB) control character.
</dd>
<dt><b>*IRS</b></dt>
<dd>Records are blocked or deblocked, based on the location of an interrecord separator (IRS) character.
</dd>
<dt><b>*NOSEP</b></dt>
<dd>No record separator character is in the transmission block sent to or received from the device. The system blocks and deblocks the records by a fixed record length, as specified in the DDS format specifications.
</dd>
<dt><b>*USER</b></dt>
<dd>The user program provides all control characters, including record separator characters, BSC framing characters, transparency characters, and any other characters needed to transmit records.
</dd>
<dt><b>*SEP</b></dt>
<dd>Records are blocked or deblocked based on the location of a user-specified record separator character.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.SEPCHAR"></a>
<h3>Separator character (SEPCHAR)</h3>
<p>Specifies a unique one-byte record separator character.
</p>
<p>Valid values range from 00 to FF; BSC control characters are not allowed.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.RMTBSCEL"></a>
<h3>Remote BSCEL (RMTBSCEL)</h3>
<p>Specifies the type of BSCEL session with the remote system.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The remote system or device cannot recognize BSCEL commands. ICF operations and return codes are used.
</dd>
<dt><b>*YES</b></dt>
<dd>The remote system can recognize BSCEL start and end commands, and BSCEL online messages.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.RCDLEN"></a>
<h3>Record length (RCDLEN)</h3>
<p>Specifies the maximum record length allowed when communicating with this device.
</p>
<p>The value must be at least the size of the largest record to be sent, but must not exceed the buffer size specified on the line description (MAXBUFFER parameter) to which this device is attached.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.BLKLEN"></a>
<h3>Block length (BLKLEN)</h3>
<p>Specifies the maximum block length allowed when communicating with this device.
</p>
<p>The value must be at least the size of the largest record to be sent, but must not exceed the buffer size specified on the line description (MAXBUFFER parameter) to which this device is attached.
</p>
<dl>
<dt><b><u>512</u></b></dt>
<dd>The record length is 512.
</dd>
</dl>
<p>
<b>Note: </b>This parameter is valid only if APPTYPE(*BSCEL) or APPTYPE(*RPGT) is specified.
</p>
<dl>
<dt><b><i>block-length</i></b></dt>
<dd>Specify the maximum block length (in bytes) of records sent. The value must be at least the size of the largest record sent. Valid values range from 1 through 32767.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.TRNSPY"></a>
<h3>Transmit in transparent mode (TRNSPY)</h3>
<p>Specifies whether the text transparency feature is used when sending blocked records. This feature permits the transmission of all 256 EBCDIC character codes; you should use this feature when transmitting packed or binary data fields.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The text transparency feature is not used.
</dd>
<dt><b>*YES</b></dt>
<dd>The text transparency feature is to be used, which permits the transmission of all 256 EBCDIC character codes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.DTACPR"></a>
<h3>Compress and decompress data (DTACPR)</h3>
<p>Specifies whether data compression is performed.
</p>
<p>
<b>Note: </b>DTACPR(*YES) cannot be specified if TRNSPY(*YES) or TRUNC(*YES) is specified. This parameter is valid only if APPTYPE(*BSCEL) or APPTYPE(*RPGT) is specified.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>No data compression or decompression occurs.
</dd>
<dt><b>*YES</b></dt>
<dd>Data is compressed for output and decompressed for input.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.TRUNC"></a>
<h3>Truncate trailing blanks (TRUNC)</h3>
<p>Specifies whether trailing blanks are removed from output records.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Trailing blanks are not removed from output records.
</dd>
<dt><b>*YES</b></dt>
<dd>Trailing blanks are removed from output records.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.GRPSEP"></a>
<h3>Group separator type (GRPSEP)</h3>
<p>Specifies a separator for groups of data, such as data sets and documents.
</p>
<dl>
<dt><b><u>*EOT</u></b></dt>
<dd>An end of transmission (EOT) control character is used.
</dd>
<dt><b>*OFCSYS</b></dt>
<dd>A transmission block ending with an end of text (ETX) control character is used.
</dd>
<dt><b>*DEV3740</b></dt>
<dd>A null record (STX ETX) is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.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="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.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="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.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="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.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="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.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="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTDEVBSC.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="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTDEVBSC.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CRTDEVBSC DEVD(BSC001) LOCADR(27) RMTLOCNAME(BSC001LC)
CTL(CTLBSC001) CNN(*PP) APPTYPE(*RJE)
</pre>
</p>
<p>This command creates a binary synchronous communications device named BSC001. Its address is X'27' and it is attached to the controller CTLBSC001. The connection type of the device is *PP and it uses the RJE application.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTDEVBSC.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="#CRTDEVBSC.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>