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

1047 lines
34 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 Ctl Desc (Async) (CRTCTLASC)</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="CRTCTLASC.Top_Of_Page"></a>
<h2>Create Ctl Desc (Async) (CRTCTLASC)</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="#CRTCTLASC.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTCTLASC.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTCTLASC.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTCTLASC"></a>
<p>The Create Controller Description (Async) (CRTCTLASC) command creates a controller description for an asynchronous controller.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTCTLASC.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="#CRTCTLASC.CTLD"><b>CTLD</b></a></td>
<td valign="top">Controller description</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.LINKTYPE"><b>LINKTYPE</b></a></td>
<td valign="top">Link type</td>
<td valign="top">*ASYNC, *X25</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.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="#CRTCTLASC.SWITCHED"><b>SWITCHED</b></a></td>
<td valign="top">Switched connection</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.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="#CRTCTLASC.LINE"><b>LINE</b></a></td>
<td valign="top">Attached nonswitched line</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.SWTLINLST"><b>SWTLINLST</b></a></td>
<td valign="top">Switched line 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="#CRTCTLASC.INLCNN"><b>INLCNN</b></a></td>
<td valign="top">Initial connection</td>
<td valign="top"><b><u>*DIAL</u></b>, *ANS</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.CNNNBR"><b>CNNNBR</b></a></td>
<td valign="top">Connection number</td>
<td valign="top"><i>Character value</i>, *ANY</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.ANSNBR"><b>ANSNBR</b></a></td>
<td valign="top">Answer number</td>
<td valign="top"><b><u>*CNNNBR</u></b>, *ANY</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.LGLCHLID"><b>LGLCHLID</b></a></td>
<td valign="top">X.25 logical channel ID</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.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="#CRTCTLASC.DEV"><b>DEV</b></a></td>
<td valign="top">Attached devices</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.PREDIALDLY"><b>PREDIALDLY</b></a></td>
<td valign="top">Predial delay</td>
<td valign="top">0-254, <b><u>6</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.REDIALDLY"><b>REDIALDLY</b></a></td>
<td valign="top">Redial delay</td>
<td valign="top">0-254, <b><u>120</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.DIALRTY"><b>DIALRTY</b></a></td>
<td valign="top">Dial retry</td>
<td valign="top">0-254, <b><u>2</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.SWTDSC"><b>SWTDSC</b></a></td>
<td valign="top">Switched disconnect</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.ACKTMR"><b>ACKTMR</b></a></td>
<td valign="top">File transfer ack timer</td>
<td valign="top">16-65535, <b><u>16</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.RETRY"><b>RETRY</b></a></td>
<td valign="top">File transfer retry</td>
<td valign="top">1-255, <b><u>7</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.RMTVFY"><b>RMTVFY</b></a></td>
<td valign="top">Remote verify</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.LCLLOCNAME"><b>LCLLOCNAME</b></a></td>
<td valign="top">Local location</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.LCLID"><b>LCLID</b></a></td>
<td valign="top">Local identifier</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.PADEML"><b>PADEML</b></a></td>
<td valign="top">PAD Emulation</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.SWTLINSLCT"><b>SWTLINSLCT</b></a></td>
<td valign="top">X.25 switched line selection</td>
<td valign="top"><b><u>*FIRST</u></b>, *CALC</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTCTLASC.DFTPKTSIZE"><b>DFTPKTSIZE</b></a></td>
<td valign="top">X.25 default packet size</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Transmit value</td>
<td valign="top">
<b><u>*LIND</u></b>, 64, 128, 256, 512, 1024, 2048, 4096</td>
</tr>
<tr>
<td valign="top">Element 2: Receive value</td>
<td valign="top">
<b><u>*LIND</u></b>, *TRANSMIT, 64, 128, 256, 512, 1024, 2048, 4096</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTCTLASC.DFTWDWSIZE"><b>DFTWDWSIZE</b></a></td>
<td valign="top">X.25 default window size</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Transmit value</td>
<td valign="top">
1-15, <b><u>*LIND</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Receive value</td>
<td valign="top">
1-15, <b><u>*LIND</u></b>, *TRANSMIT</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.USRGRPID"><b>USRGRPID</b></a></td>
<td valign="top">X.25 user group identifier</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.RVSCRG"><b>RVSCRG</b></a></td>
<td valign="top">X.25 reverse charging</td>
<td valign="top"><b><u>*NONE</u></b>, *REQUEST, *ACCEPT, *BOTH</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTCTLASC.USRFCL"><b>USRFCL</b></a></td>
<td valign="top">User facilities</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTCTLASC.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" rowspan="3"><a href="#CRTCTLASC.MSGQ"><b>MSGQ</b></a></td>
<td valign="top">Message queue</td>
<td valign="top">Single values: <b><u>*SYSVAL</u></b>, *SYSOPR<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Message queue</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top"><a href="#CRTCTLASC.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="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTCTLASC.CTLD"></a>
<h3>Controller description (CTLD)</h3>
<p>This is a required parameter.
</p>
<p>Specifies the name of the controller description.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.LINKTYPE"></a>
<h3>Link type (LINKTYPE)</h3>
<p>Specifies the type of line to which this controller is attached.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*ASYNC</b></dt>
<dd>
</dd>
</dl>
<p>This controller is attached to an asynchronous line.
</p>
<dl>
<dt><b>*X25</b></dt>
<dd>
</dd>
</dl>
<p>This controller is attached to an X.25 line.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.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>
</dd>
</dl>
<p>The controller is automatically varied on at IPL.
</p>
<dl>
<dt><b>*NO</b></dt>
<dd>
</dd>
</dl>
<p>The controller is not automatically varied on at IPL.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.SWITCHED"></a>
<h3>Switched connection (SWITCHED)</h3>
<p>Specifies whether this controller is attached to a switched line, a token-ring network, Ethernet LAN, or an X.25 switched virtual circuit (SVC). *NO must be specified for APPC controllers attached to a TDLC line.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>
</dd>
</dl>
<p>This controller is attached to a nonswitched line. Specify this value for controllers attaching to an X.25 permanent virtual circuit (PVC).
</p>
<dl>
<dt><b>*YES</b></dt>
<dd>
</dd>
</dl>
<p>This controller is attached to a switched line. Specify this value for controllers attached to an X.25 switched virtual circuit (SVC). Also specify this value for controllers attached to a local area network.
</p>
<p>
<b>Note: </b>If LINKTYPE is *LAN, the SWITCHED parameter value must be *YES or must not be specified.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.SNBU"></a>
<h3>Switched network backup (SNBU)</h3>
<p>Specifies whether the remote system modem has the switched network backup (SNBU) feature. The backup feature is used to bypass a broken nonswitched (leased line) connection by establishing a switched connection. To activate SNBU, you must change the controller description of the modem from nonswitched to switched by specifying *YES for the <b>Activate swt network backup (ACTSNBU)</b> parameter.
</p>
<p>
<b>Note: </b>If the modem model you are using is an IBM 386x, 586x, or 786x, you should not change the controller description. Instead, manually switch the modem to the unswitched mode, and manually dial the connection.
</p>
<p>Both the local and remote modems must support the SNBU feature to perform a valid activation.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The remote system modem does not have the SNBU feature.
</dd>
</dl>
<dl>
<dt><b>*YES</b></dt>
<dd>
</dd>
</dl>
<p>The remote system modem has the SNBU feature.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.LINE"></a>
<h3>Attached nonswitched line (LINE)</h3>
<p>Specifies the name of the nonswitched lines to which this controller is attached. The line description must already exist.
</p>
<p>
<b>Note: </b>The associated line must be varied off before this command is entered. Specify this parameter for controllers attaching to an X.25 permanent virtual circuit (PVC).
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.SWTLINLST"></a>
<h3>Switched line list (SWTLINLST)</h3>
<p>Specifies the names of the switched lines to which this controller attaches. The line descriptions must already exist. Up to 64 switched line names can be specified.
</p>
<dl>
<dt><b>*switched-line-name</b></dt>
<dd>
</dd>
</dl>
<p>Specify the names of up to 64 lines that are connected to this controller. The same line name can be used more than once. For each line name specified, a line description by that name must already exist.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.INLCNN"></a>
<h3>Initial connection (INLCNN)</h3>
<p>Specifies the method used to establish a connection with this controller.
</p>
<dl>
<dt><b><u>*DIAL</u></b></dt>
<dd>
</dd>
</dl>
<p>The system initiates outgoing calls and answers incoming calls.
</p>
<dl>
<dt><b>*ANS</b></dt>
<dd>
</dd>
</dl>
<p>The connection is made by the iSeries system when it answers an incoming call from this controller. If a call is received from the remote controller and all necessary conditions are met, the incoming call is answered by the system.
</p>
<p>For X.25 connections, the line attached to the controller requires switched virtual circuits (SVCs) configured on the LGLCHLE parameter of type OUT or BOTH(*SVCOUT or *SVCBOTH) for the connection to succeed.
</p>
<p>The line can be changed using the Change Line Description (X.25) (CHGLINX25) command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.CNNNBR"></a>
<h3>Connection number (CNNNBR)</h3>
<p>Specifies the telephone number to dial to connect to this controller.
</p>
<p>This could be a telephone number, an X.25 network address, or an X.21 connection number depending on the type of line the controller is attached to.
</p>
<dl>
<dt><b>*ANY</b></dt>
<dd>The system accepts calls from any network address.
</dd>
</dl>
<dl>
<dt><b><i>connection-number</i></b></dt>
<dd>
</dd>
</dl>
<p>Specify the connection number used to call this controller. This could be a telephone number or an X.25 network address.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.ANSNBR"></a>
<h3>Answer number (ANSNBR)</h3>
<p>Specifies the X.25 network address from which calls are accepted.
</p>
<dl>
<dt><b><u>*CNNNBR</u></b></dt>
<dd>
</dd>
</dl>
<p>Calls from the X.25 network address specified on the CNNNBR parameter are accepted.
</p>
<dl>
<dt><b>*ANY</b></dt>
<dd>
</dd>
</dl>
<p>Calls are accepted from any X.25 network address.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.LGLCHLID"></a>
<h3>X.25 logical channel ID (LGLCHLID)</h3>
<p>Specifies the logical channel identifier used for the X.25 permanent virtual circuit (PVC) to this controller. The valid entry is xyy. Where:
</p>
<ul>
<li>x = the logical group number, derived from your network subscription.
</li>
<li>yy = the logical channel number, derived from your subscription. The logical channel identifier must be one of the PVC logical channel identifiers that was defined in the X.25 line description. There is no default for this parameter.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the object.
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>
</dd>
</dl>
<p>No text is specified.
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>
</dd>
</dl>
<p>Specify no more than 50 characters of text, enclosed in apostrophes.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.DEV"></a>
<h3>Attached devices (DEV)</h3>
<h3>Attached devices (DEV)</h3>
<p>Specifies the names of the devices that are attached to this controller. The device descriptions must already exist.
</p>
<p>Asynchronous communications supports only one device attached to each controller. The device name must be the same as that specified when the associated device description was created. The device description must already exist.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.PREDIALDLY"></a>
<h3>Predial delay (PREDIALDLY)</h3>
<p>Specifies the time interval to wait (in 0.5 second intervals) before dialing a number.
</p>
<p>
<b>Note: </b>This parameter can be specified only if switched line or switched network backup is *YES and the link type is *ASYNC for asychronous controllers.
</p>
<dl>
<dt><b><u>6</u></b></dt>
<dd>
</dd>
</dl>
<p>The default value of 6 provides a 3-second delay.
</p>
<dl>
<dt><b><i>predial-delay</i></b></dt>
<dd>Specify a value ranging from 0 to 254 units. Each unit represents 0.5 second. To indicate no delay, specify a value of 0.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.REDIALDLY"></a>
<h3>Redial delay (REDIALDLY)</h3>
<p>Specifies the time interval to wait (in 0.5 second intervals) before re-dialing when the call attempt is unsuccessful.
</p>
<p>
<b>Note: </b>This parameter can be specified only if switched line or switched network backup is *YES and the link type is *ASYNC for asychronous controllers.
</p>
<dl>
<dt><b><u>120</u></b></dt>
<dd>The default value of 120 provides a 60-second delay.
</dd>
</dl>
<dl>
<dt><b><i>redial-delay</i></b></dt>
<dd>Specify a value from 0 to 254 units. Each unit represents 0.5 second. To indicate no delay, specify a value of 0.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.DIALRTY"></a>
<h3>Dial retry (DIALRTY)</h3>
<p>Specifies the number of re-dial attempts made by the system before considering the dialing unsuccessful.
</p>
<p>
<b>Note: </b>This parameter can be specified only if switched line or switched network backup is *YES and the link type is *ASYNC for asychronous controllers.
</p>
<dl>
<dt><b><u>2</u></b></dt>
<dd>The default number of retries is 2.
</dd>
</dl>
<dl>
<dt><b><i>dial-retry</i></b></dt>
<dd>Specify a value from 0 to 254 in 0.5-second intervals, for the number of times the dialing will be tried.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.SWTDSC"></a>
<h3>Switched disconnect (SWTDSC)</h3>
<p>Specifies whether the switched connection to this controller is dropped when the last device is varied off.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>
</dd>
</dl>
<p>The switched connection is not dropped when the last device is varied off.
</p>
<dl>
<dt><b>*YES</b></dt>
<dd>
</dd>
</dl>
<p>The switched connection is varied off when the last device is varied off.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.ACKTMR"></a>
<h3>File transfer ack timer (ACKTMR)</h3>
<p>Specifies the time period allowed for an acknowledgement when using file transfer support.
</p>
<p>Valid values range from 16 to 65535 in one-second intervals.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.RETRY"></a>
<h3>File transfer retry (RETRY)</h3>
<p>Specifies the number of retries when using file transfer support.
</p>
<p>Valid values range from 1 to 255.
</p>
<dl>
<dt><b><u>7</u></b></dt>
<dd>
</dd>
</dl>
<p>Seven is the default for number of retries.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.RMTVFY"></a>
<h3>Remote verify (RMTVFY)</h3>
<p>Specifies whether the remote system requires verification of local location NAME and local ID. The remote system requires verification if a generic controller and device are configured to accept calls from any X.25 network address.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>
</dd>
</dl>
<p>The remote system does not require verification of local location name and local ID.
</p>
<dl>
<dt><b>*YES</b></dt>
<dd>
</dd>
</dl>
<p>The remote system does require verification of the local location name and local ID.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.LCLLOCNAME"></a>
<h3>Local location (LCLLOCNAME)</h3>
<p>Specifies the name that, when combined with the local ID, identifies your controller to a remote system. This name must be the same as the name specified by the remote system in its remote location list.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.LCLID"></a>
<h3>Local identifier (LCLID)</h3>
<p>Specifies the ID that, when combined with the local location NAME, identifies your controller to a remote system. This ID must be the same as the ID specified by the remote system in its remote location list.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.PADEML"></a>
<h3>PAD Emulation (PADEML)</h3>
<p>Specifies whether this controller emulates an X.25 packet assembler/disassembler (PAD). This PAD emulation follows CCITT recommendations for X.3, X.28, and X.29. This parameter is valid only if *X25 is specified for the <b>Link type (LINKTYPE)</b> parameter, SWITCHED is *YES, and the initial connection (INLCNN) is set to *DIAL.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>
</dd>
</dl>
<p>This controller does not emulate an X.25 packet assembler/disassembler (PAD).
</p>
<dl>
<dt><b>*YES</b></dt>
<dd>
</dd>
</dl>
<p>This controller emulates an X.25 packet assembler/disassembler (PAD).
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.SWTLINSLCT"></a>
<h3>X.25 switched line selection (SWTLINSLCT)</h3>
<p>Specifies the method that is used to select lines from an X.25 switched line list.
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>
</dd>
</dl>
<p>Lines are selected beginning with the first line in the switched line list.
</p>
<dl>
<dt><b>*CALC</b></dt>
<dd>
</dd>
</dl>
<p>The system determines which line in the switched line list will be selected.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.DFTPKTSIZE"></a>
<h3>X.25 default packet size (DFTPKTSIZE)</h3>
<p>Specifies the default packet size used by the X.25 network for transmission and reception.
</p>
<p><b>Element 1: Transmit Packet Size</b>
</p>
<dl>
<dt><b><u>*LIND</u></b></dt>
<dd>
</dd>
</dl>
<p>The value specified in the line description is the default value.
</p>
<dl>
<dt><b><i>transmit-packet-size</i></b></dt>
<dd>
</dd>
</dl>
<p>Specify a default packet size for transmission. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.
</p>
<p><b>Element 2: Receive Packet Size</b>
</p>
<dl>
<dt><b><u>*LIND</u></b></dt>
<dd>
</dd>
</dl>
<p>The value specified in the line description is the default value.
</p>
<dl>
<dt><b>*TRANSMIT</b></dt>
<dd>
</dd>
</dl>
<p>The value specified as the default packet size for transmission is used as the default for reception.
</p>
<dl>
<dt><b><i>receive-packet-size</i></b></dt>
<dd>
</dd>
</dl>
<p>Specify a default packet size for reception. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.DFTWDWSIZE"></a>
<h3>X.25 default window size (DFTWDWSIZE)</h3>
<p>Specifies the default window size for transmission and reception.
</p>
<p><b>Element 1: Transmit Window Size</b>
</p>
<dl>
<dt><b><u>*LIND</u></b></dt>
<dd>
</dd>
</dl>
<p>The value specified in the line description is used as the default window size.
</p>
<dl>
<dt><b><i>transmit-window-size</i></b></dt>
<dd>
</dd>
</dl>
<p>Specify the appropriate default window size. If you specified modulus 8, valid values range from 1 through 7. If you specified modulus 128, valid values range from 1 through 15. For switched virtual circuit (SVC) incoming calls, the system accepts the window size indicated in the Incoming Call packet facilities field.
</p>
<p><b>Element 2: Receive Window Size</b>
</p>
<dl>
<dt><b><u>*LIND</u></b></dt>
<dd>
</dd>
</dl>
<p>The value specified in the line description is used as the default window size.
</p>
<dl>
<dt><b>*TRANSMIT</b></dt>
<dd>
</dd>
</dl>
<p>The value specified as the default window size for transmission is used as the default for reception.
</p>
<dl>
<dt><b><i>receive-window-size</i></b></dt>
<dd>
</dd>
</dl>
<p>Specify the appropriate default window size. If you specified modulus 8, valid values range from 1 through 7. If you specified modulus 128, valid values range from 1 through 15.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.USRGRPID"></a>
<h3>X.25 user group identifier (USRGRPID)</h3>
<p>Specifies the closed user-group ID for contacting this switched virtual circuit (SVC) controller on the X.25 network.
</p>
<p>Specify the 2-digit decimal value, from 00 through 99, as provided by the network subscription. This parameter is not valid for permanent virtual circuit (PVC) connections. It is valid only for SVC circuit outgoing call operations and is ignored for SVC incoming call connections.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.RVSCRG"></a>
<h3>X.25 reverse charging (RVSCRG)</h3>
<p>Specifies whether reverse charges are accepted or requested when contacting this controller.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>
</dd>
</dl>
<p>No reverse charging for network tariff billing is accepted.
</p>
<dl>
<dt><b>*REQUEST</b></dt>
<dd>
</dd>
</dl>
<p>Charges are requested on outgoing call request packets.
</p>
<dl>
<dt><b>*ACCEPT</b></dt>
<dd>
</dd>
</dl>
<p>Reverse charging for network tariff billing is accepted on incoming requests.
</p>
<dl>
<dt><b>*BOTH</b></dt>
<dd>
</dd>
</dl>
<p>Both incoming and outgoing requests are accepted.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.USRFCL"></a>
<h3>User facilities (USRFCL)</h3>
<p>Specifies a string of hexadecimal characters sent to the X.25 network to request additional services. The system allows up to 218 hexadecimal characters.
</p>
<p>
<b>Note: </b>Values entered in this field are determined by the supplier of the network subscription. Do not include coding of facilities shown through keywords: packet size, window size, user group identifier, and reverse charging.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.CMNRCYLMT"></a>
<h3>Recovery limits (CMNRCYLMT)</h3>
<p>Specifies the number of recovery attempts made by the system before an inquiry message is sent to the system operator. Also specifies the time (in minutes) that must elapse before the system sends an inquiry message to the system operator indicating that the recovery attempt count limit is reached.
</p>
<p><b>Element 1: Maximum Recovery Limit</b>
</p>
<dl>
<dt><b><u>2</u></b></dt>
<dd>
</dd>
</dl>
<p>Two recovery attempts are made within the interval specified.
</p>
<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>
</dd>
</dl>
<p>Specify the number of second-level recovery attempts to be made. Valid values range from 0 through 99.
</p>
<p><b>Element 2: Recovery Time Interval</b>
</p>
<dl>
<dt><b><u>5</u></b></dt>
<dd>
</dd>
</dl>
<p>The specified number of recovery attempts is made within a 5-minute interval.
</p>
<dl>
<dt><b><i>time-interval</i></b></dt>
<dd>
</dd>
</dl>
<p>Specify the time interval (in minutes) at which the specified number of second-level recoveries are attempted. Valid values range from 0 through 120. If the value specified for <i>count-limit</i> is not 0, the value 0 specifies infinite recovery.
</p>
<p>More information on communication recovery is in the Communcations Management book, SC41-5406.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.MSGQ"></a>
<h3>Message queue (MSGQ)</h3>
<p>Specifies the message queue to which operational messages are sent.
</p>
<dl>
<dt><b><u>*SYSVAL</u></b></dt>
<dd>Messages are sent to the message queue defined in the QCFGMSGQ system value.
</dd>
</dl>
<dl>
<dt><b>*SYSOPR</b></dt>
<dd>Messages are sent to the system operator message queue (QSYS/QSYSOPR).
</dd>
</dl>
<p><b>Qualifier 1: Message queue</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the message queue to which operational messages are sent.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the message queue is located.
</dd>
</dl>
<p>For more information about using this command, see the Communcations Management book, SC41-5406.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTCTLASC.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="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTCTLASC.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CRTCTLASC CTLD(ASCCTL) LINKTYPE(*ASYNC) LINE(ASCLIN)
</pre>
</p>
<p>This command creates an asynchronous controller attached to a nonswitched asynchronous line.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTCTLASC.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF26BB</b></dt>
<dd>Extended wireless controller member not changed.
</dd>
<dt><b>CPF26BC</b></dt>
<dd>Extended wireless controller member not displayed.
</dd>
<dt><b>CPF26BD</b></dt>
<dd>Entry for barcode group not removed from extended wireless controller member.
</dd>
<dt><b>CPF26BE</b></dt>
<dd>Entry for PTC group not removed from extended wireless controller member.
</dd>
<dt><b>CPF26BF</b></dt>
<dd>Program QZXCINZ terminated abnormally. See previous messages.
</dd>
<dt><b>CPF26B3</b></dt>
<dd>Extended wireless line member not added.
</dd>
<dt><b>CPF26B4</b></dt>
<dd>Extended wireless line member not changed.
</dd>
<dt><b>CPF26B5</b></dt>
<dd>Extended wireless line member not displayed.
</dd>
<dt><b>CPF26B8</b></dt>
<dd>Extended wireless controller member not added.
</dd>
<dt><b>CPF2716</b></dt>
<dd>Controller description &amp;1 not created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTCTLASC.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>