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

150 lines
5.3 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>Change IP over SNA TOS (CHGIPSTOS)</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="CHGIPSTOS.Top_Of_Page"></a>
<h2>Change IP over SNA TOS (CHGIPSTOS)</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="#CHGIPSTOS.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGIPSTOS.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGIPSTOS.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGIPSTOS"></a>
<p>The Change IP over SNA Type of Service (CHGIPSTOS) command is used to change the SNA mode associated with each IP type of service.
</p>
<p><b>Notes:</b>
</p>
<ol>
<li>For AF_INET sockets over SNA, the sockets application must select the desired IP type of service before the connection is established. After the connection is established, the sockets application can change the IP type of service, but it has not affect on the SNA mode associated with the underlying APPC conversation carrying the socket connection. The APPC conversation will continue to use the SNA mode that was in effect when the conversation was established.
</li>
<li>Changes to a SNA mode made with the Change Mode Description (CHGMODD) CL command will not take effect for an APPC device that is currently using that mode until the mode has been started again for the APPC device.
</li>
</ol>
<p><b>Restriction:</b> The user must have *IOSYSCFG authority to use this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGIPSTOS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGIPSTOS.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="#CHGIPSTOS.TOS"><b>TOS</b></a></td>
<td valign="top">Type of service</td>
<td valign="top">*MINDELAY, *MAXTHRPUT, *MAXRLB, *MINCOST, *NORMAL</td>
<td valign="top">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGIPSTOS.MODE"><b>MODE</b></a></td>
<td valign="top">Mode</td>
<td valign="top"><i>Communications name</i>, *NETATR</td>
<td valign="top">Required, Positional 2</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGIPSTOS.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGIPSTOS.TOS"></a>
<h3>Type of service (TOS)</h3>
<p>Specifies the IP type of service to be changed.
</p>
<p>This is a required parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b>*MINDELAY</b></dt>
<dd>Minimize delay means that prompt delivery is important for data on this connection.
</dd>
<dt><b>*MAXTHRPUT</b></dt>
<dd>Maximize throughput means that a high data rate is important for data on this connection.
</dd>
<dt><b>*MAXRLB</b></dt>
<dd>Maximize reliability means that a higher level of effort to ensure delivery is important for data on this connection.
</dd>
<dt><b>*MINCOST</b></dt>
<dd>Minimize monetary cost means that lower cost is important for data on this connection.
</dd>
<dt><b>*NORMAL</b></dt>
<dd>Normal service is used for delivery of data.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGIPSTOS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGIPSTOS.MODE"></a>
<h3>Mode (MODE)</h3>
<p>Specifies the SNA mode description used with this type of service. The mode can be one to eight characters in length. The first character must be A (or a) through Z (or z), or special characters $, #, or @ followed by 0 through 9, A (or a) through Z (or z), $, #, or @.
</p>
<p>This is a required parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b>*NETATR</b></dt>
<dd>The default mode name defined in the network attributes is used.
</dd>
<dt><b><i>mode</i></b></dt>
<dd>Specify the name of an SNA mode description.
<p><b>Restriction:</b> The SNASVCMG and CPSVCMG modes are reserved for system use and cannot be specified for the MODE parameter.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGIPSTOS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGIPSTOS.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGIPSTOS TOS(*MINDELAY) MODE(MODE1)
</pre>
</p>
<p>This command changes the SNA mode for IP type of service *MINDELAY to MODE1.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGIPSTOS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGIPSTOS.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPFA112</b></dt>
<dd>IP over SNA type of service not changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGIPSTOS.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>