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

593 lines
17 KiB
HTML
Raw 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>Change Ctl Desc (BSC) (CHGCTLBSC)</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="CHGCTLBSC.Top_Of_Page"></a>
<h2>Change Ctl Desc (BSC) (CHGCTLBSC)</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="#CHGCTLBSC.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGCTLBSC.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGCTLBSC.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGCTLBSC"></a>
<p>The Change Controller Description (BSC) (CHGCTLBSC) command changes a controller description for a binary synchronous communications (BSC) controller.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGCTLBSC.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="#CHGCTLBSC.CTLD"><b>CTLD</b></a></td>
<td valign="top">Controller description</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCTLBSC.ONLINE"><b>ONLINE</b></a></td>
<td valign="top">Online at IPL</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCTLBSC.ACTSNBU"><b>ACTSNBU</b></a></td>
<td valign="top">Activate swt network backup</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCTLBSC.SWTLINLST"><b>SWTLINLST</b></a></td>
<td valign="top">Switched line list</td>
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values (up to 64 repetitions): <i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCTLBSC.INLCNN"><b>INLCNN</b></a></td>
<td valign="top">Initial connection</td>
<td valign="top"><b><u>*SAME</u></b>, *ANS, *DIAL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCTLBSC.CNNNBR"><b>CNNNBR</b></a></td>
<td valign="top">Connection number</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCTLBSC.PREDIALDLY"><b>PREDIALDLY</b></a></td>
<td valign="top">Predial delay</td>
<td valign="top">0-254, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCTLBSC.REDIALDLY"><b>REDIALDLY</b></a></td>
<td valign="top">Redial delay</td>
<td valign="top">0-254, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCTLBSC.DIALRTY"><b>DIALRTY</b></a></td>
<td valign="top">Dial retry</td>
<td valign="top">0-254, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCTLBSC.LCLID"><b>LCLID</b></a></td>
<td valign="top">Local identifier</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NOID</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCTLBSC.RMTID"><b>RMTID</b></a></td>
<td valign="top">Remote identifiers</td>
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values (up to 64 repetitions): <i>Character value</i>, *ANY, *NOID</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCTLBSC.RJEHOST"><b>RJEHOST</b></a></td>
<td valign="top">RJE host type</td>
<td valign="top"><b><u>*SAME</u></b>, *RES, *JES2, *JES3, *RSCS</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCTLBSC.RJELOGON"><b>RJELOGON</b></a></td>
<td valign="top">RJE host signon/logon</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGCTLBSC.CMNRCYLMT"><b>CMNRCYLMT</b></a></td>
<td valign="top">Recovery limits</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *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</td>
</tr>
<tr>
<td valign="top">Element 2: Time interval</td>
<td valign="top">
0-120</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCTLBSC.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGCTLBSC.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="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLBSC.ONLINE"></a>
<h3>Online at IPL (ONLINE)</h3>
<p>Specifies whether this object is automatically varied on at initial program load (IPL).
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>
</dd>
</dl>
<p>This value does not change.
</p>
<dl>
<dt><b>*YES</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="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLBSC.ACTSNBU"></a>
<h3>Activate swt network backup (ACTSNBU)</h3>
<p>Specifies, for modems that support the switched network backup (SNBU) feature and that are not IBM 386x, 586x, or 786x models, whether the SNBU feature is activated or deactivated. The local modem and remote modem must both support the SNBU to activate it. IBM 386x, 586x, and 786x models are activated with a hardware switch only. This feature lets you bypass a broken nonswitched connection (nonswitched line) by establishing a switched connection.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>
</dd>
</dl>
<p>This value does not change.
</p>
<dl>
<dt><b>*NO</b></dt>
<dd>
</dd>
</dl>
<p>The SNBU feature is not used.
</p>
<dl>
<dt><b>*YES</b></dt>
<dd>
</dd>
</dl>
<p>The SNBU feature is activated. You must also specify a value of *YES for the <b>Activate swt network backup (ACTSNBU)</b> parameter for the line.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLBSC.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><u>*SAME</u></b></dt>
<dd>
</dd>
</dl>
<p>This value does not change.
</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="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLBSC.INLCNN"></a>
<h3>Initial connection (INLCNN)</h3>
<p>Specifies the method used to establish a connection with this controller.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>
</dd>
</dl>
<p>This value does not change.
</p>
<dl>
<dt><b>*DIAL</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="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLBSC.CNNNBR"></a>
<h3>Connection number (CNNNBR)</h3>
<p>Specifies the telephone number to dial to connect to this controller.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>
</dd>
</dl>
<p>This value does not change.
</p>
<dl>
<dt><b><i>connection-number</i></b></dt>
<dd>
</dd>
</dl>
<p>Specify the connection number.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLBSC.PREDIALDLY"></a>
<h3>Predial delay (PREDIALDLY)</h3>
<p>Specifies the time interval to wait (in 0.5 second intervals) before dialing a number.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>
</dd>
</dl>
<p>This value does not change.
</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="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLBSC.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>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>
</dd>
</dl>
<p>This value does not change.
</p>
<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="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLBSC.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>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>
</dd>
</dl>
<p>This value does not change.
</p>
<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="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLBSC.LCLID"></a>
<h3>Local identifier (LCLID)</h3>
<p>Specifies the local ID used to identify the local system to the remote controller.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>
</dd>
</dl>
<p>This value does not change.
</p>
<dl>
<dt><b>*NOID</b></dt>
<dd>
</dd>
</dl>
<p>The local system sends a null identifier when communicating with the controller.
</p>
<dl>
<dt><b><i>local-id</i></b></dt>
<dd>
</dd>
</dl>
<p>Specify a local ID that is from 2 to 30 hexadecimal characters long and contains an even number of characters. The identifier cannot contain any BSC control characters.
</p>
<p>The following guidelines are recommended to help ensure that the telephone connection is made to the correct BSC controller:
</p>
<ul>
<li>The local ID should be a minimum of 4 characters.
</li>
<li>If the ID is only 4 characters, the first 2 and last 2 should be the same (example: F3F3 or 8484).
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLBSC.RMTID"></a>
<h3>Remote identifiers (RMTID)</h3>
<p>Specifies the identifiers for remote BSC controllers. A maximum of 64 remote controller IDs can be specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>
</dd>
</dl>
<p>This value does not change.
</p>
<dl>
<dt><b>*NOID</b></dt>
<dd>
</dd>
</dl>
<p>The local system accepts a null identifier sent by the remote system.
</p>
<dl>
<dt><b>*ANY</b></dt>
<dd>
</dd>
</dl>
<p>The system accepts any identifier sent by the remote controller.
</p>
<p>
<b>Note: </b>This value is valid only when it is the last or the only value specified.
</p>
<dl>
<dt><b><i>remote-ID</i></b></dt>
<dd>
</dd>
</dl>
<p>Specify a remote controller ID that is from 2 to 30 hexadecimal characters long and contains an even number of characters. The identifier cannot contain any BSC control characters.
</p>
<p>The following guidelines are recommended to help ensure that the phone connection is made to the correct BSC controller:
</p>
<ul>
<li>The remote ID should be a minimum of 4 characters.
</li>
<li>If the ID is only 4 characters, the first 2 and last 2 should be the same (example: F1F1 or 8585).
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLBSC.RJEHOST"></a>
<h3>RJE host type (RJEHOST)</h3>
<p>Specifies the subsystem type of the host to which RJE is connected.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>
</dd>
</dl>
<p>This value does not change.
</p>
<dl>
<dt><b>*RES</b></dt>
<dd>
</dd>
</dl>
<p>The host is RES (Remote Entry System).
</p>
<dl>
<dt><b>*JES2</b></dt>
<dd>
</dd>
</dl>
<p>The host is JES2 (Job Entry Subsystem 2).
</p>
<dl>
<dt><b>*JES3</b></dt>
<dd>
</dd>
</dl>
<p>The host is JES3 (Job Entry Subsystem 3).
</p>
<dl>
<dt><b>*RSCS</b></dt>
<dd>
</dd>
</dl>
<p>The host is RSCS (Remote Spooling Communications System).
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLBSC.RJELOGON"></a>
<h3>RJE host signon/logon (RJELOGON)</h3>
<p>Specify up to 80 characters of text, enclosed in apostrophes, used as sign-on text for the RJE host system. This parameter is required only when APPTYPE(*RJE) is specified. Specify the sign-on information required by the host system.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>
</dd>
</dl>
<p>This value does not change.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLBSC.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>*SAME</u></b></dt>
<dd>
</dd>
</dl>
<p>This value does not change.
</p>
<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><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>
<dl>
<dt><b>*SYSVAL</b></dt>
<dd>The value in the QCMNRCYLMT system value is used.
</dd>
</dl>
<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="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCTLBSC.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the object.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>
</dd>
</dl>
<p>This value does not change.
</p>
<dl>
<dt><b>*BLANK</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="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGCTLBSC.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGCTLBSC CTLD(VRTCTL325) LCLID(ABAB)
</pre>
</p>
<p>This command changes the controller named VRTCTL325 to have the local identifier ABAB.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGCTLBSC.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2652</b></dt>
<dd>Controller description &amp;1 not changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCTLBSC.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>