151 lines
5.3 KiB
HTML
151 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>Convert Network ID / Location (CVTIPSLOC)</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="CVTIPSLOC.Top_Of_Page"></a>
|
|
<h2>Convert Network ID / Location (CVTIPSLOC)</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="#CVTIPSLOC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CVTIPSLOC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CVTIPSLOC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CVTIPSLOC"></a>
|
|
<p>The Convert IP over SNA Location Entry (CVTIPSLOC) command is used to convert a specified SNA network identifier and location name into one or more associated IP addresses. The location entries defined with the ADD IP over SNA Location Entry (ADDIPSLOC) CL command are searched to find one or more IP addresses that are associated with the input SNA location name (LOC) and SNA network identifier (NETID).
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTIPSLOC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CVTIPSLOC.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="#CVTIPSLOC.NETID"><b>NETID</b></a></td>
|
|
<td valign="top">Network identifier</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*NETATR</u></b></td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CVTIPSLOC.LOC"><b>LOC</b></a></td>
|
|
<td valign="top">Location name</td>
|
|
<td valign="top"><i>Communications name</i></td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CVTIPSLOC.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*</u></b>, *PRINT</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTIPSLOC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CVTIPSLOC.NETID"></a>
|
|
<h3>Network identifier (NETID)</h3>
|
|
<p>Specifies the SNA network identifier for the local host or a remote host.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NETATR</u></b></dt>
|
|
<dd>The network identifier in the network attributes for this host is used.
|
|
</dd>
|
|
<dt><b><i>network-identifier</i></b></dt>
|
|
<dd>Specify the network identifier for the local host or a remote host. The network identifier 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 @.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTIPSLOC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CVTIPSLOC.LOC"></a>
|
|
<h3>Location name (LOC)</h3>
|
|
<p>Specifies the SNA location name to be converted.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>location-name</i></b></dt>
|
|
<dd>Specify the SNA location name for the local host or a remote host. This name 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 @.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTIPSLOC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CVTIPSLOC.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies where the results are returned.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
|
|
</dd>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>The output is printed with the job's spooled output.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTIPSLOC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CVTIPSLOC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CVTIPSLOC LOC(LUNAMEX) OUTPUT(*PRINT)
|
|
</pre>
|
|
</p>
|
|
<p>This command converts the location name LUNAMEX with the default network identifier specified in the network attributes and places the results in the job's spooled output.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTIPSLOC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CVTIPSLOC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPFA115</b></dt>
|
|
<dd>SNA network identifier and location name not converted.
|
|
</dd>
|
|
<dt><b>CPFA119</b></dt>
|
|
<dd>No associated internet address found.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CVTIPSLOC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|