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

1119 lines
39 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>Create Line Desc (BSC) (CRTLINBSC)</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="CRTLINBSC.Top_Of_Page"></a>
<h2>Create Line Desc (BSC) (CRTLINBSC)</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="#CRTLINBSC.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTLINBSC.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTLINBSC.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTLINBSC"></a>
<p>The Create Line Description (BSC) (CRTLINBSC) command creates a line description for a BSC line.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTLINBSC.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="#CRTLINBSC.LIND"><b>LIND</b></a></td>
<td valign="top">Line description</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.RSRCNAME"><b>RSRCNAME</b></a></td>
<td valign="top">Resource name</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.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="#CRTLINBSC.APPTYPE"><b>APPTYPE</b></a></td>
<td valign="top">Application type</td>
<td valign="top"><b><u>*PGM</u></b>, *RJE, *EML</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.INTERFACE"><b>INTERFACE</b></a></td>
<td valign="top">Physical interface</td>
<td valign="top"><b><u>*RS232V24</u></b>, *RS449V36, *RS530V36, *V35, *X21BISV24, *X21BISV35</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.CNN"><b>CNN</b></a></td>
<td valign="top">Connection type</td>
<td valign="top"><b><u>*NONSWTPP</u></b>, *SWTPP, *MPTRIB</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.SNBU"><b>SNBU</b></a></td>
<td valign="top">Switched network backup</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.VRYWAIT"><b>VRYWAIT</b></a></td>
<td valign="top">Vary on wait</td>
<td valign="top">15-180, <b><u>*NOWAIT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.AUTOCALL"><b>AUTOCALL</b></a></td>
<td valign="top">Autocall unit</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.STNADR"><b>STNADR</b></a></td>
<td valign="top">Station address</td>
<td valign="top">04-FE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.CLOCK"><b>CLOCK</b></a></td>
<td valign="top">Clocking</td>
<td valign="top"><b><u>*MODEM</u></b>, *SYSTEM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.DUPLEX"><b>DUPLEX</b></a></td>
<td valign="top">Duplex</td>
<td valign="top"><b><u>*HALF</u></b>, *FULL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.LINESPEED"><b>LINESPEED</b></a></td>
<td valign="top">Line speed</td>
<td valign="top">600, 1200, 2400, 4800, 7200, <b><u>9600</u></b>, 14400, 19200, 48000, 56000, 57600</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.MODEM"><b>MODEM</b></a></td>
<td valign="top">Modem type supported</td>
<td valign="top"><b><u>*NORMAL</u></b>, *V54, *IBMWRAP</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.SWTCNN"><b>SWTCNN</b></a></td>
<td valign="top">Switched connection type</td>
<td valign="top"><b><u>*BOTH</u></b>, *ANS, *DIAL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.AUTOANS"><b>AUTOANS</b></a></td>
<td valign="top">Autoanswer</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.AUTODIAL"><b>AUTODIAL</b></a></td>
<td valign="top">Autodial</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.DIALCMD"><b>DIALCMD</b></a></td>
<td valign="top">Dial command type</td>
<td valign="top"><b><u>*NONE</u></b>, *V25BIS</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.ACRSRCNAME"><b>ACRSRCNAME</b></a></td>
<td valign="top">Autocall resource name</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.CALLNBR"><b>CALLNBR</b></a></td>
<td valign="top">Calling number</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.INACTTMR"><b>INACTTMR</b></a></td>
<td valign="top">Inactivity timer</td>
<td valign="top">150-4200, <b><u>300</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.MAXBUFFER"><b>MAXBUFFER</b></a></td>
<td valign="top">Maximum buffer size</td>
<td valign="top">8-8192, <b><u>1024</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.CODE"><b>CODE</b></a></td>
<td valign="top">Character code</td>
<td valign="top"><b><u>*EBCDIC</u></b>, *ASCII</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.RCVTMR"><b>RCVTMR</b></a></td>
<td valign="top">Receive timer</td>
<td valign="top">30-254, <b><u>30</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.CONTTMR"><b>CONTTMR</b></a></td>
<td valign="top">Continue timer</td>
<td valign="top">16-24, <b><u>20</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.CTNRTY"><b>CTNRTY</b></a></td>
<td valign="top">Contention state retry</td>
<td valign="top">0-21, <b><u>7</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.DTASTTRTY"><b>DTASTTRTY</b></a></td>
<td valign="top">Data state retry</td>
<td valign="top">0-255, <b><u>7</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.TMTRTY"><b>TMTRTY</b></a></td>
<td valign="top">Transmit TTD or WACK retry</td>
<td valign="top">0-65534, <b><u>60</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.RCVRTY"><b>RCVRTY</b></a></td>
<td valign="top">Receive TTD or WACK retry</td>
<td valign="top">0-65534, <b><u>45</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.DSRDRPTMR"><b>DSRDRPTMR</b></a></td>
<td valign="top">Data Set Ready drop timer</td>
<td valign="top">3-60, <b><u>6</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.AUTOANSTYP"><b>AUTOANSTYP</b></a></td>
<td valign="top">Autoanswer type</td>
<td valign="top"><b><u>*DTR</u></b>, *CDSTL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.RMTANSTMR"><b>RMTANSTMR</b></a></td>
<td valign="top">Remote answer timer</td>
<td valign="top">30, 35, 40, 45, 50, 55, <b><u>60</u></b>, 65, 70, 75, 80, 85, 90, 95, 100, 105, 110, 115, 120</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.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="#CRTLINBSC.CTL"><b>CTL</b></a></td>
<td valign="top">Attached nonswitched ctls</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.SWTCTLLST"><b>SWTCTLLST</b></a></td>
<td valign="top">Switched controller list</td>
<td valign="top">Values (up to 64 repetitions): <i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.MODEMRATE"><b>MODEMRATE</b></a></td>
<td valign="top">Modem data rate select</td>
<td valign="top"><b><u>*FULL</u></b>, *HALF</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.SYNCCHARS"><b>SYNCCHARS</b></a></td>
<td valign="top">SYN characters</td>
<td valign="top"><b><u>2</u></b>, 4</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.THRESHOLD"><b>THRESHOLD</b></a></td>
<td valign="top">Error threshold level</td>
<td valign="top"><b><u>*OFF</u></b>, *MIN, *MED, *MAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.STXLRC"><b>STXLRC</b></a></td>
<td valign="top">Include STX character in LRC</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.CTSTMR"><b>CTSTMR</b></a></td>
<td valign="top">Clear To Send timer</td>
<td valign="top">10-60, <b><u>25</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTLINBSC.CMNRCYLMT"><b>CMNRCYLMT</b></a></td>
<td valign="top">Recovery limits</td>
<td valign="top">Single values: *SYSVAL<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Count limit</td>
<td valign="top">
0-99, <b><u>2</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Time interval</td>
<td valign="top">
0-120, <b><u>5</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#CRTLINBSC.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="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTLINBSC.LIND"></a>
<h3>Line description (LIND)</h3>
<p>Specifies the name of the line description
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.RSRCNAME"></a>
<h3>Resource name (RSRCNAME)</h3>
<p>Specifies the resource name that describes the automatic call unit port.
</p>
<p>
<b>Note: </b>Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name. The resource name is on the port. For example, the resource name may be CMN01 on an Ethernet port.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.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>*YES</b></dt>
<dd>The line is automatically varied on at initial program load (IPL).
</dd>
<dt><b>*NO</b></dt>
<dd>This line is not automatically varied on at IPL.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.APPTYPE"></a>
<h3>Application type (APPTYPE)</h3>
<p>Specifies the application type used by this device.
</p>
<dl>
<dt><b>*PGM</b></dt>
<dd>This BSC line is used by a user-written program (not RJE or EML).
</dd>
<dt><b>*RJE</b></dt>
<dd>This BSC line is used by the Remote Job Entry Facility.
</dd>
<dt><b>*EML</b></dt>
<dd>This BSC line is used by 3270 device emulation.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.INTERFACE"></a>
<h3>Physical interface (INTERFACE)</h3>
<p>Specifies the type of physical interface on the input/output adapter (IOA) port.
</p>
<dl>
<dt><b>*RS232V24 (Async, BSC, X.25 and SDLC only)</b></dt>
<dd>RS-232/V.24 physical interface.
</dd>
</dl>
<dl>
<dt><b>*V35 (BSC and SDLC only)</b></dt>
<dd>V.35 physical interface.
</dd>
</dl>
<dl>
<dt><b>*X21 (X.25 and SDLC only)</b></dt>
<dd>X.21 physical interface.
</dd>
</dl>
<dl>
<dt><b>*X21BISV24 (X.25, BSC and SDLC only)</b></dt>
<dd>X.21 bis/V.24 physical interface.
</dd>
</dl>
<dl>
<dt><b>*X21BISV35 (X.25, BSC and SDLC only)</b></dt>
<dd>X.21 bis/V.35 physical interface.
</dd>
</dl>
<dl>
<dt><b>*RS449V36 (Async, BSC, X.25 and SDLC only)</b></dt>
<dd>RS-449/V.36 physical interface.
</dd>
</dl>
<dl>
<dt><b>*INTMODEM</b></dt>
<dd>The integrated modem interface is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.CNN"></a>
<h3>Connection type (CNN)</h3>
<p>Specifies the type of line connection.
</p>
<dl>
<dt><b>*NONSWTPP</b></dt>
<dd>A nonswitched point-to-point line is used.
</dd>
</dl>
<p>
<b>Note: </b>This value cannot be selected if you choose *EML for the <b>Application type (APPTYPE)</b> parameter.
</p>
<dl>
<dt><b>*SWTPP</b></dt>
<dd>A switched point-to-point line is used.
</dd>
</dl>
<p>
<b>Note: </b>This value cannot be selected if you choose *EML for the <b>Application type (APPTYPE)</b> parameter.
</p>
<dl>
<dt><b>*MPTRIB</b></dt>
<dd>A multipoint tributary line.
</dd>
</dl>
<p>
<b>Note: </b>This value cannot be selected if you choose *RJE for the <b>Application type (APPTYPE)</b> parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.SNBU"></a>
<h3>Switched network backup (SNBU)</h3>
<p>Specifies, for nonswitched modems only, if the local modem supports the switched network backup utility (SNBU) feature. The backup feature is used to bypass a broken nonswitched (nonswitched line) connection by establishing a switched connection.
</p>
<p>To activate SNBU, you must change the mode of the modem from nonswitched to switched. If the modem model is IBM 386x, 586x, or 786x, no change is required. Otherwise, specify *YES for the <b>Activate swt network backup (ACTSNBU)</b> parameter for the line description you are using.
</p>
<dl>
<dt><b>*NO</b></dt>
<dd>The local modem does not have the SNBU feature.
</dd>
<dt><b>*YES</b></dt>
<dd>The local modem has the SNBU feature.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.VRYWAIT"></a>
<h3>Vary on wait (VRYWAIT)</h3>
<p>Specifies whether the line is varied on asynchronously or synchronously. For synchronous vary on, this parameter specifies how long the system waits for the vary on to complete.
</p>
<dl>
<dt><b>*NOWAIT</b></dt>
<dd>The system does not wait for vary on completion. The line is varied on asynchronously.
</dd>
<dt><b><i>vary-on-wait</i></b></dt>
<dd>Specify the time (in seconds) to wait. Valid values range from 15 through 180. The system waits until the line is varied on, or until the specified time passes, before completing the Vary Configuration (VRYCFG) command.
</dd>
</dl>
<p><b>Notes:</b>
</p>
<ol>
<li>When ONLINE(*YES) is used, specifying a wait time in the line description affects system IPL time. In such cases, system IPL time is influenced by the amount of time required to synchronously vary on the line or reach the wait-time value.
</li>
<li>The time required to vary on a line is the time it takes to:
<ul>
<li>Put tasks in place to manage the line
</li>
<li>Activate the communications I/O processor (IOP), including downloading the IOP model-unique Licensed Internal Code
</li>
<li>Establish the communications tasks and processes
</li>
</ul>
</li>
</ol>
<p>Normal vary-on time ranges from 5 through 45 seconds, but can be longer, depending on the system, line protocol, and other factors.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.AUTOCALL"></a>
<h3>Autocall unit (AUTOCALL)</h3>
<p>Specifies, for switched or switched network backup lines (Async, BSC, SDLC, or X.25 line), whether the line has an associated automatic call unit that can automatically call the remote system.
</p>
<dl>
<dt><b>*NO</b></dt>
<dd>No automatic call unit is associated with this line.
</dd>
<dt><b>*YES</b></dt>
<dd>An automatic call unit is associated with this line.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.STNADR"></a>
<h3>Station address (STNADR)</h3>
<p>Specifies, for multipoint tributary lines, the hexadecimal address by which the local system is known to the remote system. The hexadecimal address is the polling address assigned to this system.
</p>
<p>If a character code of *ASCII is specified, any address with the 6-bit set on cannot be used. If a character code of *EBCDIC is specified, any address with the 2-bit set on cannot be used.
</p>
<dl>
<dt><b><i>station-address</i></b></dt>
<dd>Specify a hexadecimal value from 04 to FE. BSC control characters can not be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.CLOCK"></a>
<h3>Clocking (CLOCK)</h3>
<p>Specifies how the clocking function for the line is provided.
</p>
<dl>
<dt><b>*MODEM</b></dt>
<dd>The clocking function for the line is provided by the modem.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.DUPLEX"></a>
<h3>Duplex (DUPLEX)</h3>
<p>Specifies whether request-to-send (RTS) is permanently turned on (for duplex modems) or turned on only when transmission is required (for half duplex modems).
</p>
<dl>
<dt><b>*HALF</b></dt>
<dd>Request-to-send (RTS) is turned on only when transmission is required (for half duplex modems). You can choose to run half duplex even if the modem can support duplex communication.
</dd>
<dt><b>*FULL</b></dt>
<dd>Request-to-send (RTS) is permanently set on (for duplex modems).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.LINESPEED"></a>
<h3>Line speed (LINESPEED)</h3>
<p>Specifies the line speed in bits per second (bps).
</p>
<dl>
<dt><b>1200</b></dt>
<dd>1200 bps is used.
</dd>
<dt><b><i>line-speed</i></b></dt>
<dd>Specify the line speeds. Valid lines speeds are: 50, 75, 110, 150, 300 600, 1200, 2400 4800, 7200, 9600, 14400, 19200, 28800, 38400, 57600, 76800, or 115200 bits per second.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.MODEM"></a>
<h3>Modem type supported (MODEM)</h3>
<p>Specifies the type of modem supported on the communications line. Refer to the modem manual to determine the appropriate value to select.
</p>
<dl>
<dt><b>*NORMAL</b></dt>
<dd>No attempt is made to run a diagnostic test to your modem.
</dd>
<dt><b>*V54</b></dt>
<dd>A certain type of diagnostic test (as defined by the CCITT recommendations) is run to your modem. This system supports CCITT V.54 loop 3, local loop back, and loop 2, which is a remote loop back.
</dd>
<dt><b>*IBMWRAP</b></dt>
<dd>An IBM modem with wrap test capabilities is used on the communications line.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.SWTCNN"></a>
<h3>Switched connection type (SWTCNN)</h3>
<p>Specifies whether the switched (Async, BSC, SDLC, or IDLC) line or switched network backup (Async, BSC, or SDLC) line is used for incoming calls, outgoing calls, or both.
</p>
<dl>
<dt><b>*BOTH</b></dt>
<dd>The line is used for both incoming and outgoing calls.
</dd>
</dl>
<dl>
<dt><b>*ANS</b></dt>
<dd>The line is used for incoming calls only.
</dd>
</dl>
<dl>
</dl>
<dl>
<dt><b>*DIAL</b></dt>
<dd>The line is used for outgoing calls only.
</dd>
</dl>
<dl>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.AUTOANS"></a>
<h3>Autoanswer (AUTOANS)</h3>
<p>Specifies, for switched or switched network backup lines (Async, BSC, SDLC, or X.25 line), whether the system automatically answers a call from a remote system to establish the connection, or whether the system operator manually answers the call and places the modem in data mode.
</p>
<p>
<b>Note: </b>*YES is a valid option only if the modem has the automatic answer feature.
</p>
<dl>
<dt><b>*YES</b></dt>
<dd>The incoming call is automatically answered by the automatic answer feature.
</dd>
<dt><b>*NO</b></dt>
<dd>The incoming call must be manually answered.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.AUTODIAL"></a>
<h3>Autodial (AUTODIAL)</h3>
<p>Specifies, for switched lines, whether the system automatically calls a remote system to establish a connection or if the system operator must manually place the call.
</p>
<dl>
<dt><b>*NO</b></dt>
<dd>The line connection is made by manually dialing the X.25 network.
</dd>
<dt><b>*YES</b></dt>
<dd>The line connection is made by the system automatically dialing the X.25 network.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.DIALCMD"></a>
<h3>Dial command type (DIALCMD)</h3>
<p>Specifies the type of dial command used to establish a switched connection with a remote system.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No dial command is used. (An automatic call unit is used to establish the connection.)
</dd>
</dl>
<dl>
<dt><b>*V25BIS</b></dt>
<dd>V.25 bis is a recommendation which allows the use of one physical interface for call establishment and data transmission. It is referred to as a serial automatic call interface because the digits are presented serially on the link from the system to the modem.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.ACRSRCNAME"></a>
<h3>Autocall resource name (ACRSRCNAME)</h3>
<p>Specifies the automatic call resource name that describes the automatic call unit port that is used to establish a connection with a remote system. Use the Work with Hardware Resources (WRKHDWRSC) command to determine the resource name.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.CALLNBR"></a>
<h3>Calling number (CALLNBR)</h3>
<p>Specifies the local telephone number of the line that is used for the V.25 bis Call Request with Identification (CRI) dial command. When V.25 bis CRI dialing is used, the system takes the called (connection) number (CNNNBR parameter ), adds a separator character (;), and puts the calling number at the end. The default, *NONE, indicates that Call Request Normal (CRN) is used.
</p>
<p>Specify the calling number only when the modem and network support the CRI dial command.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>Call Request Normal (CRN) is used. CRN dialing sends only the connection number to the V.25 bis modem.
</dd>
</dl>
<dl>
<dt><b><i>calling-number</i></b></dt>
<dd>Specify the local telephone number if V.25 bis CRI dialing is required. The number can be up to 32 characters in length. See your modem documentation to determine the values allowed by the modem.
</dd>
</dl>
<p>
<b>Note: </b>Specify the calling number only if both the modem and network support the V.25 bis CRI dial command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.INACTTMR"></a>
<h3>Inactivity timer (INACTTMR)</h3>
<p>Specifies the time (in tenths of a second) the system waits for activity on a switched line before disconnecting the line.
</p>
<dl>
<dt><b>*NOMAX</b></dt>
<dd>The system waits indefinitely for activity.
</dd>
</dl>
<dl>
<dt><b><i>inactivity-timer</i></b></dt>
<dd>Specify a value from 150 to 4200 units. Each unit represents 0.1 second, which provides a time range of 0.3 to 9.9 seconds.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.MAXBUFFER"></a>
<h3>Maximum buffer size (MAXBUFFER)</h3>
<p>Specifies the maximum size of inbound and outbound data buffers.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.CODE"></a>
<h3>Character code (CODE)</h3>
<p>Specifies whether the extended binary-coded decimal interchange code (*EBCDIC) or the American National Standard Code for Information Interchange (*ASCII) character code is used on the line.
</p>
<dl>
<dt><b>*EBCDIC</b></dt>
<dd>The EBCDIC character set code is used.
</dd>
</dl>
<dl>
<dt><b>*ASCII</b></dt>
<dd>The ASCII character code is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.RCVTMR"></a>
<h3>Receive timer (RCVTMR)</h3>
<p>Specifies the duration of time the system waits for data from the remote system before a receive timeout occurs.
</p>
<dl>
<dt><b><i>receive-timer</i></b></dt>
<dd>Specify a value from 30 to 254 in 0.1-second intervals.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.CONTTMR"></a>
<h3>Continue timer (CONTTMR)</h3>
<p>Specifies, when the system is not ready to transmit or receive data, the duration of time the system waits before sending a control character which prevents the line from becoming inoperative. This parameter is not valid for an application type of RJE.
</p>
<dl>
<dt><b><i>continue-timer</i></b></dt>
<dd>Specify a value from 16 to 24 in 0.1-second intervals.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.CTNRTY"></a>
<h3>Contention state retry (CTNRTY)</h3>
<p>Specifies the number of contention state retries to attempt before indicating the error and making the line inoperative.
</p>
<p>For BSC, contention is the state that exists after the end of transmission (EOT) character is received or sent and before a starting sequence (ENQ) has been positively acknowledged (ACK0).
</p>
<p>In data communications, a type of half-duplex line or link control in which either user may transmit any time the line/link is available. In the event that both users attempt to transmit a request simultaneously, the protocols or the hardware determines who wins the contention.
</p>
<dl>
<dt><b><i>contention-state-retry</i></b></dt>
<dd>Specify a value from 0 to 21 for the number of contention state retries.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.DTASTTRTY"></a>
<h3>Data state retry (DTASTTRTY)</h3>
<p>Specifies the number of data state retries to attempt before indicating the error and ending the session.
</p>
<p>For BSC, a data state is a time during which BSC is sending or receiving characters on the communications line.
</p>
<dl>
<dt><b><i>data-state-retry</i></b></dt>
<dd>Specify a value from 0 to 255 for the number of data state retries.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.TMTRTY"></a>
<h3>Transmit TTD or WACK retry (TMTRTY)</h3>
<p>Specifies the number of retries for transmitting temporary text delay (TTD) or wait before transmitting (WACK) before indicating a session failure. This parameter is not valid for an application type of RJE.
</p>
<dl>
<dt><b>*NOMAX</b></dt>
<dd>Retries are attempted indefinitely.
</dd>
</dl>
<dl>
<dt><b><i>transmit-TTD-or-WACK-retry</i></b></dt>
<dd>Specify a value from 0 to 65534 for the number of retries.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.RCVRTY"></a>
<h3>Receive TTD or WACK retry (RCVRTY)</h3>
<p>Specifies the number of retries for receiving temporary text delay (TTD) or wait before transmitting (WACK) before indicating a session failure. This parameter can only be specified if the application type is program-to-program.
</p>
<dl>
<dt><b>*NOMAX</b></dt>
<dd>Retries are attempted indefinitely.
</dd>
</dl>
<dl>
<dt><b><i>receive-TTD-or-WACK-retry</i></b></dt>
<dd>Specify a value from 0 to 65534 for the number of retries.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.DSRDRPTMR"></a>
<h3>Data Set Ready drop timer (DSRDRPTMR)</h3>
<p>Specifies the amount of time that the system waits for the modem to exit the Data Set Ready (DSR) state before signaling an error.
</p>
<dl>
<dt><b><i>drop-timer</i></b></dt>
<dd>Specify a value ranging from 3 through 60 seconds.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.AUTOANSTYP"></a>
<h3>Autoanswer type (AUTOANSTYP)</h3>
<p>Specifies the method that the system uses to answer incoming calls.
</p>
<dl>
<dt><b>*DTR</b></dt>
<dd>The system enters the Data Terminal Ready state, signals the modem to answer calls, and waits for the modem to enter the Data Set Ready (DSR) state.
</dd>
<dt><b>*CDSTL</b></dt>
<dd>The system enters the Connect Data Set to Line (CDSTL) state after monitoring the Ring Indicator to signal the modem to answer the call.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.RMTANSTMR"></a>
<h3>Remote answer timer (RMTANSTMR)</h3>
<p>Specifies the amount of time that system waits for the modem to enter the Data Set Ready (DSR) state after dialing before signaling an error.
</p>
<dl>
<dt><b><i>answer-timer</i></b></dt>
<dd>Specify a value ranging from 30 through 120 seconds in 5-second intervals.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies text that briefly describes the line description.
</p>
<dl>
<dt><b>*BLANK</b></dt>
<dd>Text is not 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="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.CTL"></a>
<h3>Attached nonswitched ctls (CTL)</h3>
<p>Specifies, for nonswitched lines, the names of one or more controllers to which this line is attached. The controller descriptions must already exist.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.SWTCTLLST"></a>
<h3>Switched controller list (SWTCTLLST)</h3>
<p>Specifies the names of up to 64 switched controllers that can establish a connection with this switched line. The controller descriptions must already exist. This parameter is valid only if the line is switched or the nonswitched line has the switched network backup (SNBU) feature.
</p>
<p>You can enter multiple values for this parameter.
</p>
<dl>
<dt><b><i>switched-controller-list</i></b></dt>
<dd>Specify the switched controller names. Up to 64 switched controllers can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.MODEMRATE"></a>
<h3>Modem data rate select (MODEMRATE)</h3>
<p>Specifies the speed at which the line operates if the modem has the data rate select feature.
</p>
<dl>
<dt><b>*FULL</b></dt>
<dd>The line operates at the full rate of the modem.
</dd>
<dt><b>*HALF</b></dt>
<dd>The line operates at half the full rate of the modem.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.SYNCCHARS"></a>
<h3>SYN characters (SYNCCHARS)</h3>
<p>Specifies the number of BSC SYN (synchronous) control characters to send when transmitting. The SYN control character is used to establish and maintain synchronization and as a time fill in the absence of any data or other control character.
</p>
<dl>
<dt><b>2</b></dt>
<dd>The synchronization pattern consists of two consecutive SYN characters.
</dd>
<dt><b>4</b></dt>
<dd>The synchronization pattern consists of four consecutive SYN characters.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.THRESHOLD"></a>
<h3>Error threshold level (THRESHOLD)</h3>
<p>Specifies the temporary error threshold level being monitored by the system. A permanent error is reported only if the errors occurred consecutively and exceeded the retry limit.
</p>
<p>
<b>Note: </b>Specifying the THRESHOLD parameter affects all threshold errors. They cannot be specified individually.
</p>
<dl>
<dt><b>*OFF</b></dt>
<dd>No threshold errors are reported.
</dd>
</dl>
<dl>
<dt><b>*MIN</b></dt>
<dd>The threshold for errors is set to a minimum monitoring level.
</dd>
</dl>
<dl>
<dt><b>*MED</b></dt>
<dd>The threshold for errors is set to a medium monitoring level.
</dd>
</dl>
<dl>
<dt><b>*MAX</b></dt>
<dd>The threshold for errors is set to a maximum monitoring level.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.STXLRC"></a>
<h3>Include STX character in LRC (STXLRC)</h3>
<p>Specifies whether the start of text (STX) control character is included in the longitudinal redundancy check (LRC) calculation. This applies only to lines using the ASCII character code.
</p>
<dl>
<dt><b>*NO</b></dt>
<dd>The STX control character is not included in the LRC calculation.
</dd>
<dt><b>*YES</b></dt>
<dd>The STX control character is included in the LRC calculation.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.CTSTMR"></a>
<h3>Clear To Send timer (CTSTMR)</h3>
<p>Specifies the amount of time the system waits for the modem to enter or exit the Clear to Send (CTS) state before signaling an error.
</p>
<dl>
<dt><b><i>cts-timer</i></b></dt>
<dd>Specify a value ranging from 10 through 60 seconds.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.CMNRCYLMT"></a>
<h3>Recovery limits (CMNRCYLMT)</h3>
<p>Specifies the second-level communications recovery limits to be used for this line description.
</p>
<p>The possible <b>count-limit</b> values are:
</p>
<dl>
<dt><b>2</b></dt>
<dd>Two recovery attempts are made within the specified time interval.
</dd>
</dl>
<dl>
<dt><b>*SYSVAL</b></dt>
<dd>The value in the QCMNRCYLMT system value is used.
</dd>
</dl>
<dl>
<dt><b><i>count-limit</i></b></dt>
<dd>Specify the number of recovery attempts to be performed by the system. Valid values range from 0 through 99.
</dd>
</dl>
<p>The possible <b>time-interval</b> values are:
</p>
<dl>
<dt><b>5</b></dt>
<dd>The specified number of recovery attempts are made within a 5-minute interval.
</dd>
</dl>
<dl>
<dt><b><i>time-interval</i></b></dt>
<dd>Specify the number of minutes within which recovery attempts are made. Valid values range from 0 through 120 in 1-minute intervals.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTLINBSC.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="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTLINBSC.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CRTLINBSC LIND(BRANCHES) RSRCNAME(LIN021)
ONLINE(*NO) CNN(*SWTPP)
AUTOCALL(*YES) ACRSRCNAME(LIN032)
SWTCTLLST(BRANCH1 BRANCH2)
</pre>
</p>
<p>This command creates a BSC line description for the first port on the second IOA. It is set up to autodial on the second port of the third IOA, or to automatic answer. The controller descriptions in the SWTCTLLST already exist.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTLINBSC.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2718</b></dt>
<dd>Line description &amp;1 not created due to errors.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTLINBSC.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>