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

142 lines
5.4 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>Remove Point-to-Point Profile (RMVTCPPTP)</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="RMVTCPPTP.Top_Of_Page"></a>
<h2>Remove Point-to-Point Profile (RMVTCPPTP)</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="#RMVTCPPTP.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVTCPPTP.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVTCPPTP.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVTCPPTP"></a>
<p>The Remove Point-to-Point TCP/IP Profile (RMVTCPPTP) command is used to remove a point-to-point connection profile. There could be an output queue (*OUTQ) object associated with the profile (QUSRSYS/profile-name) and this *OUTQ would also be removed.
</p>
<p>Optionally, all associated communications objects associated with this profile can also be deleted.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVTCPPTP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVTCPPTP.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="#RMVTCPPTP.CFGPRF"><b>CFGPRF</b></a></td>
<td valign="top">Configuration profile</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#RMVTCPPTP.DLTCMNCFG"><b>DLTCMNCFG</b></a></td>
<td valign="top">Delete communications config</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RMVTCPPTP.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVTCPPTP.CFGPRF"></a>
<h3>Configuration profile (CFGPRF)</h3>
<p>Specifies the point-to-point configuration profile to be removed.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the name of a valid, inactive point-to-point configuration profile to be removed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVTCPPTP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVTCPPTP.DLTCMNCFG"></a>
<h3>Delete communications config (DLTCMNCFG)</h3>
<p>Specifies whether you want to delete all communications configuration objects associated with this point-to-point profile. This would include the line, controller and device descriptions defined for use with this profile. Optionally, for some profile types this could also include any network interface descriptions and connection lists associated with the line description being deleted.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Do not delete any of the communications configuration currently associated with this point-to-point profile.
</dd>
<dt><b>*YES</b></dt>
<dd>Delete the communications configuration associated with this point-to-point profile.
<p>
<b>Note: </b>If the communications configuration object to be deleted is found to have other point-to-point profiles or line descriptions using it or is not in a 'VARIED OFF' state, it will not be deleted. If a communications object is not deleted a message will be sent indicating the reason.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVTCPPTP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVTCPPTP.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Delete a Point-to-Point Profile</b>
</p>
<p>
<pre>
RMVTCPPTP CFGPRF(SLIPPROF)
</pre>
</p>
<p>This command will remove the point-to-point profile named SLIPPROF. Any communications configuration objects associated with this profile will not be deleted.
</p>
<p><b>Example 2: Delete Profile and Related Communications Configuration Objects</b>
</p>
<p>
<pre>
RMVTCPPTP CFGPRF(ANSPROF) DLTCMNCFG(*YES)
</pre>
</p>
<p>This command will remove the point-to-point profile named ANSPROF and all communications configuration objects associated with the profile. Additionally, if any of the configuration objects are found to be shared with other point-to-point profiles, such as a line description, then the object will <b>not</b> be deleted. If an object is not deleted, a diagnostic message will be sent indicating which object was not deleted and why.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVTCPPTP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVTCPPTP.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>TCP83E0</b></dt>
<dd>Point-to-point profile &amp;1 not removed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVTCPPTP.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>