friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
0332907f0f
ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/qtoclstnetifc.htm

2557 lines
76 KiB
HTML
Raw Normal View History

Add readme and dist folders
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">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>List Network Interface (QtocLstNetIfc) API</title>
<!-- Begin Header Records -->
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<!-- Created for V5R1-->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!-- 050602 SGLEZ Add new V5R4 IPv6/IPv4 fields -->
<!-- Edited by Sglez Jun 05 ========================================= -->
<!-- End Header Records ============================================= -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<a name="Top_Of_Page"></a>
<!--Java sync-link-->
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
</script>
<h2>List Network Interfaces (QtocLstNetIfc) API</h2>
<div class="box" style="width: 60%;">
&nbsp;&nbsp;Required Parameter Group:<br>
<!-- iddvc RMBR -->
<br>
<table width="100%">
<tr>
<td align="center" valign="top" width="10%">1</td>
<td align="left" valign="top" width="50%">Qualified user space name</td>
<td align="left" valign="top" width="20%">Input</td>
<td align="left" valign="top" width="20%">Char(20)</td>
</tr>
<tr>
<td align="center" valign="top">2</td>
<td align="left" valign="top">Format name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(8)</td>
</tr>
<tr>
<td align="center" valign="top">3</td>
<td align="left" valign="top">Error Code</td>
<td align="left" valign="top">I/O</td>
<td align="left" valign="top">Char(*)</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Service Program: QTOCNETSTS<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: Yes<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The List Network Interfaces
(QtocLstNetIfc) API returns a list of all logical TCP/IP interfaces with
details. This API returns all IPv4 logical interfaces using one output format
name, and all IPv6 logical interfaces using a different output format name.</p>
<p>TCP/IP must be active; otherwise error message TCP84C0 will be issued.</p>
<br>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>User Space Library Authority</em></dt>
<dd>*EXECUTE</dd>
<dt><em>User Space Authority</em></dt>
<dd>*CHANGE</dd>
<dt><em>User Space Lock</em></dt>
<dd>*SHRNUP</dd>
</dl>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Qualified user space name</strong></dt>
<dd>INPUT; CHAR(20)<br>
<p>The user space that is to receive the created list. The first 10 characters
contain the user space name, and the second 10 characters contain the name of
the library in which the user space is located. You can use these special
values for the library name:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*CURLIB</em></td>
<td align="left" valign="top">The job's current library</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LIBL</em></td>
<td align="left" valign="top">The library list</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Format name</strong></dt>
<dd>INPUT; CHAR(8)<br>
<p>The format of the logical interface information to be returned. The format
names supported are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>NIFC0100</em></td>
<td align="left" valign="top">Detailed information about each TCP/IPv4 network
interface. Refer to <a href="#NIFC0100">NIFC0100 Format</a> for details on the
format.</td>
</tr>
<tr>
<td align="left" valign="top"><em>NIFC0200</em></td>
<td align="left" valign="top">Detailed information about each TCP/IPv6 network
interface. Refer to <a href="#NIFC0200">NIFC0200 Format</a> for details on the
format.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Error code</strong></dt>
<dd>I/O; CHAR(*)
<p>The structure in which to return error information. For the format of the
structure, see <a href="../apiref/error.htm#hdrerrcod">Error Code Parameter</a>.</p>
</dd>
</dl>
<br>
<br>
<h3><a name="HDRSPCA0">Format of Interface Lists</a></h3>
<p>To request a list of all logical interfaces, use format NIFC0100. </p>
<p>The interface description list consists of:</p>
<ul>
<li>A user area</li>
<li>A generic header</li>
<li>An input parameter section</li>
<li>A header section</li>
<li>A list data section:
<ul>
<li>NIFC0100 format, or</li>
<li>NIFC0200 format</li>
</ul>
</li>
</ul>
<p>For details about the user area and generic header, see <a href=
"../apiref/usf.htm">User Space Format for List APIs</a>. For details about the remaining
items, see the following sections.</p>
<p>When you retrieve list entry information from a user space, you must use the
entry size returned in the generic header. The size of each entry may be padded
at the end. If you do not use the entry size, the result may not be valid. For
examples of how to process lists, see API <a href=
"../apiref/apiexmp.htm">Examples</a>.</p>
<br>
<h3><a name="HDRSPCA01"></a>Input Parameter Section</h3>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">User space name specified</td>
</tr>
<tr>
<td align="center" valign="top">10</td>
<td align="center" valign="top">A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User space library name specified</td>
</tr>
<tr>
<td align="center" valign="top">20</td>
<td align="center" valign="top">14</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Format name specified</td>
</tr>
<tr>
<td align="center" valign="top">28</td>
<td align="center" valign="top">1C</td>
<td align="left" valign="top">&nbsp;</td>
<td align="left" valign="top">&nbsp;</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRSPCA02"></a>Header Section</h3>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">User space name used</td>
</tr>
<tr>
<td align="center" valign="top">10</td>
<td align="center" valign="top">A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User space library name used</td>
</tr>
<tr>
<td align="center" valign="top">20</td>
<td align="center" valign="top">14</td>
<td align="left" valign="top">&nbsp;</td>
<td align="left" valign="top">&nbsp;</td>
</tr>
</table>
<br>
<br>
<h3><a name="FRCD">Format of
Returned Connection Data</a></h3>
<p>To retrieve the list of TCP/IPv4 network interfaces, request format <a href=
"#NIFC0100">NIFC0100</a>, and you will get a repeating list of NIFC0100 tables,
each one returning information about a single IPv4 network interface. To
retrieve the list of TCP/IPv6 network interfaces, request format <a href=
"#NIFC0200">NIFC0200</a>, and you will get a repeating list of NIFC0200 tables,
each one returning information about a single IPv6 network interface.</p>
<br>
<h3><a name="NIFC0100">NIFC0100 Format</a></h3>
<p>The following information about each TCP/IPv4 logical interface is returned
for the NIFC0100 format. For detailed descriptions of the fields in the table,
see <a href="#NIFC0100_FIELD">Field Descriptions</a>.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">CHAR(15)</td>
<td align="left" valign="top" width="60%">Internet address</td>
</tr>
<tr>
<td align="center" valign="top">15</td>
<td align="center" valign="top">F</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">16</td>
<td align="center" valign="top">10</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Internet address binary</td>
</tr>
<tr>
<td align="center" valign="top">20</td>
<td align="center" valign="top">14</td>
<td align="left" valign="top">CHAR(15)</td>
<td align="left" valign="top">Network address</td>
</tr>
<tr>
<td align="center" valign="top">35</td>
<td align="center" valign="top">23</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">36</td>
<td align="center" valign="top">24</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Network address binary</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Network name</td>
</tr>
<tr>
<td align="center" valign="top">50</td>
<td align="center" valign="top">32</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Line description</td>
</tr>
<tr>
<td align="center" valign="top">60</td>
<td align="center" valign="top">3C</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Interface name</td>
</tr>
<tr>
<td align="center" valign="top">70</td>
<td align="center" valign="top">46</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">72</td>
<td align="center" valign="top">48</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Interface status</td>
</tr>
<tr>
<td align="center" valign="top">76</td>
<td align="center" valign="top">4C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Interface type of service</td>
</tr>
<tr>
<td align="center" valign="top">80</td>
<td align="center" valign="top">50</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Interface MTU</td>
</tr>
<tr>
<td align="center" valign="top">84</td>
<td align="center" valign="top">54</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Interface line type</td>
</tr>
<tr>
<td align="center" valign="top">88</td>
<td align="center" valign="top">58</td>
<td align="left" valign="top">CHAR(15)</td>
<td align="left" valign="top">Host address</td>
</tr>
<tr>
<td align="center" valign="top">103</td>
<td align="center" valign="top">67</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">104</td>
<td align="center" valign="top">68</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Host address binary</td>
</tr>
<tr>
<td align="center" valign="top">108</td>
<td align="center" valign="top">6C</td>
<td align="left" valign="top">CHAR(15)</td>
<td align="left" valign="top">Interface subnet mask</td>
</tr>
<tr>
<td align="center" valign="top">123</td>
<td align="center" valign="top">7B</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">124</td>
<td align="center" valign="top">7C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Interface subnet mask binary</td>
</tr>
<tr>
<td align="center" valign="top">128</td>
<td align="center" valign="top">80</td>
<td align="left" valign="top">CHAR(15)</td>
<td align="left" valign="top">Directed broadcast address</td>
</tr>
<tr>
<td align="center" valign="top">143</td>
<td align="center" valign="top">8F</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">144</td>
<td align="center" valign="top">90</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Directed broadcast address binary</td>
</tr>
<tr>
<td align="center" valign="top">148</td>
<td align="center" valign="top">94</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Change date</td>
</tr>
<tr>
<td align="center" valign="top">156</td>
<td align="center" valign="top">9C</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Change time</td>
</tr>
<tr>
<td align="center" valign="top">162</td>
<td align="center" valign="top">A2</td>
<td align="left" valign="top">CHAR(15)</td>
<td align="left" valign="top">Associated local interface</td>
</tr>
<tr>
<td align="center" valign="top">177</td>
<td align="center" valign="top">B1</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">180</td>
<td align="center" valign="top">B4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Associated local interface binary</td>
</tr>
<tr>
<td align="center" valign="top">184</td>
<td align="center" valign="top">B8</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Change status</td>
</tr>
<tr>
<td align="center" valign="top">188</td>
<td align="center" valign="top">BC</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Packet rules</td>
</tr>
<tr>
<td align="center" valign="top">192</td>
<td align="center" valign="top">C0</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Automatic start</td>
</tr>
<tr>
<td align="center" valign="top">196</td>
<td align="center" valign="top">C4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">TRLAN bit sequencing</td>
</tr>
<tr>
<td align="center" valign="top">200</td>
<td align="center" valign="top">C8</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Interface type</td>
</tr>
<tr>
<td align="center" valign="top">204</td>
<td align="center" valign="top">CC</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Proxy ARP enabled</td>
</tr>
<tr>
<td align="center" valign="top">208</td>
<td align="center" valign="top">D0</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Proxy ARP allowed</td>
</tr>
<tr>
<td align="center" valign="top">212</td>
<td align="center" valign="top">D4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Configured MTU</td>
</tr>
<tr>
<td align="center" valign="top">216</td>
<td align="center" valign="top">D8</td>
<td align="left" valign="top">CHAR(24)</td>
<td align="left" valign="top">Network name - full</td>
</tr>
<tr>
<td align="center" valign="top">240</td>
<td align="center" valign="top">F0</td>
<td align="left" valign="top">CHAR(24)</td>
<td align="left" valign="top">Interface name - full</td>
</tr>
<tr>
<td align="center" valign="top"><img src="delta.gif" alt="Start of change">264</td>
<td align="center" valign="top">108</td>
<td align="left" valign="top">CHAR(50)</td>
<td align="left" valign="top">Alias name</td>
</tr>
<tr>
<td align="center" valign="top">314</td>
<td align="center" valign="top">13A</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">316</td>
<td align="center" valign="top">13C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Alias name CCSID</td>
</tr>
<tr>
<td align="center" valign="top">320</td>
<td align="center" valign="top">140</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to preferred interface list</td>
</tr>
<tr>
<td align="center" valign="top">324</td>
<td align="center" valign="top">144</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of entries in preferred interface list</td>
</tr>
<tr>
<td align="center" valign="top">328</td>
<td align="center" valign="top">148</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of one preferred interface list entry</td>
</tr>
<tr>
<td align="left" valign="top" colspan=2>This field repeats for each preferred interface list entry</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Preferred interface list entry (See
<a href="#FMTPRFIFC">Format of Preferred Interface List Entry</a>
for more information.)<img src="deltaend.gif" alt="End of change"></td>
</tr>
</table>
<br>
<br>
<h3><img src="delta.gif" alt="Start of change"><a name="FMTPRFIFC"></a>
Format of Preferred Interface List Entry</h3>
<p>The preferred interface list entry describes the data returned for each entry
in the preferred interface list of the NIFC0100 format. For detailed
descriptions of the fields in the table, see <a href="#NIFC0100_FIELD">Field Descriptions</a>.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">CHAR(15)</td>
<td align="left" valign="top" width="60%">Preferred interface internet address</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">15</td>
<td align="center" valign="top" width="10%">F</td>
<td align="left" valign="top" width="20%">CHAR(1)</td>
<td align="left" valign="top" width="60%">Reserved</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">16</td>
<td align="center" valign="top" width="10%">10</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Preferred interface internet address binary</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">20</td>
<td align="center" valign="top" width="10%">14</td>
<td align="left" valign="top" width="20%">CHAR(*)</td>
<td align="left" valign="top" width="60%">Reserved<img src="deltaend.gif" alt="End of change"></td>
</tr>
</table>
<h3><a name="NIFC0100_FIELD"></a>Field Descriptions</h3>
<p><img src="delta.gif" alt="Start of change"><strong>Alias name.</strong>
Name given to the interface to use as an alternate to the IP address.</p>
<p><strong>Alias name CCSID.</strong> Coded character set ID for the alias name.
<img src="deltaend.gif" alt="End of change"></p>
<p><strong>Associated local interface.</strong> The internet address, in dotted
decimal notation, of the local interface that has been associated with this
interface. The following is a special value:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*NONE</em></td>
<td align="left" valign="top">No association has been made between this
interface and another local interface.</td>
</tr>
</table>
<p><strong>Associated local interface binary.</strong> Binary representation of
the associated local interface. The following is a special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">No association has been made between this
interface and another local interface.</td>
</tr>
</table>
<p><strong>Automatic start.</strong> Whether the interface is started
automatically when the TCP/IP stack is activated. Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">NO. This interface is not started
automatically.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">YES. This interface is started
automatically.</td>
</tr>
</table>
<p><strong>Change date.</strong> The date of the most recent change to this
interface in the dynamic tables used by the TCP/IP protocol stack. It is
returned as 8 characters in the form YYYYMMDD, where:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top">YYYY</td>
<td align="left" valign="top">Year</td>
</tr>
<tr>
<td align="left" valign="top">MM</td>
<td align="left" valign="top">Month</td>
</tr>
<tr>
<td align="left" valign="top">DD</td>
<td align="left" valign="top">Day</td>
</tr>
</table>
<p><strong>Change status.</strong> The status of the most recent change to this
interface in the dynamic tables used by the TCP/IP protocol stack.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Add interface request processed</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Change interface request processed</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Start interface request processed</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">End interface request processed</td>
</tr>
</table>
<p><strong>Change time.</strong> The time of the most recent change to this
interface in the dynamic tables used by the TCP/IP protocol stack. It is
returned as 6 characters in the form HHMMSS, where:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top">HH</td>
<td align="left" valign="top">Hour</td>
</tr>
<tr>
<td align="left" valign="top">MM</td>
<td align="left" valign="top">Minute</td>
</tr>
<tr>
<td align="left" valign="top">SS</td>
<td align="left" valign="top">Second</td>
</tr>
</table>
<p><strong>Configured MTU.</strong> The configured maximum transmission unit
value specified for this interface. The following is a special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">LIND. The interface is not active currently and
the MTU was specified as *LIND.</td>
</tr>
</table>
<p><strong>Directed broadcast address.</strong> The internet address, in dotted
decimal notation, used to broadcast to all systems attached to the same network
or subnetwork as this interface. The following is a special value:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*NONE</em></td>
<td align="left" valign="top">The interface is attached to a network that does
not support a broadcast operation.</td>
</tr>
</table>
<p><strong>Directed broadcast address binary.</strong> Binary representation of
the directed broadcast address. The following is a special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The interface is attached to a network that does
not support a broadcast operation.</td>
</tr>
</table>
<p><strong>Host address.</strong> Host portion of the internet address, in
dotted decimal notation, as determined by the subnet mask specified for this
interface.</p>
<p><strong>Host address binary.</strong> Binary representation of the host
address.</p>
<p><strong>Interface line type.</strong> Type of line used by an interface. The
following link protocols are supported:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>-1</em></td>
<td align="left" valign="top">OTHER -<br>
IPI - An Internet Protocol (IP) over Internetwork Pack Exchange (IPX)
interface.<br>
IPS - An Internet Protocol (IP) over SNA interface.<br>
<img src="delta.gif" alt="Start of change">
PPPoE - Point-to-Point over Ethernet protocol.
<img src="deltaend.gif" alt="End of change">
<p><strong>Note:</strong> As of V5R2,
IP over IPX is no longer supported.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>-2</em></td>
<td align="left" valign="top">NONE - Line is not defined. This is used for the
following interfaces:&nbsp;&nbsp;*LOOPBACK, *VIRTUALIP, *OPC. There is no line
type value for these interfaces.</td>
</tr>
<tr>
<td align="left" valign="top"><em>-3</em></td>
<td align="left" valign="top">ERROR - This value is displayed if any system
errrors other than those for *NOTFND are received while trying to determine the
link type for an interface.</td>
</tr>
<tr>
<td align="left" valign="top"><em>-4</em></td>
<td align="left" valign="top">NOTFND - Not found. This value is displayed if
the line description object for this interface cannot be found.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">ELAN - Ethernet local area network protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">TRLAN - Token-ring local area network
protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">FR - Frame relay network protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">ASYNC - Asynchronous communications
protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">PPP - Point-to-point Protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>6</em></td>
<td align="left" valign="top">WLS - Wireless local area network protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>7</em></td>
<td align="left" valign="top">X.25 - X.25 protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>8</em></td>
<td align="left" valign="top">DDI - Distributed Data Interface protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>9</em></td>
<td align="left" valign="top">TDLC - Twinaxial Datalink Control. Used for
TCP/IP over Twinax.</td>
</tr>
<tr>
<td align="left" valign="top"><em>10</em></td>
<td align="left" valign="top">L2TP (Virtual PPP) - Layer Two Tunneling
Protocol.</td>
</tr>
</table>
<p><strong>Interface MTU.</strong> Maximum transmission unit value specified
for this interface. The following are special values:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>-1</em></td>
<td align="left" valign="top">OTHER.<br>
IPI - An Internet Protocol (IP) over Internetwork Pack Exchange (IPX)
interface.<br>
IPS - An Internet Protocol (IP) over SNA interface.
<p><strong>Note:</strong> As of V5R2,
IP over IPX is no longer supported.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">LIND - The interface is not active currently and
the MTU was specified as *LIND.</td>
</tr>
</table>
<p><strong>Interface name.</strong> The first 10 characters of the name of this
interface.</p>
<p><strong> Interface name -
full.</strong> The complete 24 character interface name.</p>
<p><strong>Interface status.</strong> Current status of this logical
interface.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Inactive - The interface has not been started.
The interface is not active.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Active - The interface has been started and is
running.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Starting - The system is processing the request
to start this interface.</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Ending - The system is processing the request to
end this interface.</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">RCYPND - An error with the physical line
associated with this interface was detected by the system. The line description
associated with this interface is in the recovery pending (RCYPND) state.</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">RCYCNL - A hardware failure has occurred and the
line description associated with this interface is in the recovery canceled
(RCYCNL) state.</td>
</tr>
<tr>
<td align="left" valign="top"><em>6</em></td>
<td align="left" valign="top">Failed - The line description associated with
this interface has entered the failed state.</td>
</tr>
<tr>
<td align="left" valign="top"><em>7</em></td>
<td align="left" valign="top">Failed (TCP) - An error was detected in the IBM
TCP/IP Vertical Licensed Internal Code.</td>
</tr>
<tr>
<td align="left" valign="top"><em>8</em></td>
<td align="left" valign="top">DOD - Point-to-Point (PPP) Dial-on-Demand.</td>
</tr>
</table>
<p><strong>Interface subnet mask.</strong> The subnet mask for the network,
subnet, and host address fields of the internet address, in dotted decimal
notation, that defines the subnetwork for an interface.</p>
<p><strong>Interface subnet mask binary.</strong> Binary representation of the
interface subnet mask.</p>
<p><strong>Interface type.</strong> The interface types are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Broadcast capable</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Non-broadcast capable</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Unnumbered network</td>
</tr>
</table>
<p><strong>Interface type of service.</strong> The way in which the internet
hosts and routers should make trade-offs between throughput, delay, reliability
and cost. The following are special values:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>-1</em></td>
<td align="left" valign="top">OTHER -<br>
IPI - An Internet Protocol (IP) over Internetwork Pack Exchange (IPX)
interface.<br>
IPS - An Internet Protocol (IP) over SNA interface.
<p><strong>Note:</strong> As of V5R2,
IP over IPX is no longer supported.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">NORMAL - Used for delivery of datagrams.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">MINDELAY - Prompt delivery of datagrams with the
minimize delay indication.</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">MAXTHRPUT - Datagrams with maximize throughput
indication.</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">MAXRLB - Datagrams with maximize reliability
indication.</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">MINCOST - Datagram with minimize monetary cost
indication.</td>
</tr>
</table>
<p><strong>Internet address.</strong> The internet address, in dotted decimal
notation, of an interface.</p>
<p><strong>Internet address binary.</strong> Binary representation of the
internet address.</p>
<p><img src="delta.gif" alt="Start of change"><strong>Length of one preferred
interface list entry.</strong> The length of a preferred interface
list entry. For virtual interfaces, a length of zero means that a preferred
interface list is not being used. For other types of interfaces, this field is
set to zero.<img src="deltaend.gif" alt="End of change"></p>
<p><strong>Line description</strong> Name of the communications line
description that identifies the physical network associated with an interface.
The following are special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*IPI</em></td>
<td align="left" valign="top">This interface is used by Internet Protocol (IP)
over Internetwork Packet Exchange (IPX).
<p><strong>Note:</strong> As of V5R2,
IP over IPX is no longer supported.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*IPS</em></td>
<td align="left" valign="top">This interface is used by Internet Protocol (IP)
over SNA.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LOOPBACK</em></td>
<td align="left" valign="top">This is a loopback interface. Processing
associated with a loopback interface does not extend to a physical line.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*VIRTUALIP</em></td>
<td align="left" valign="top">The virtual interface is a circuitless interface.
It is used in conjunction with the associated local interface (LCLIFC) when
adding standard interfaces.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*OPC</em></td>
<td align="left" valign="top">This interface is attached to the optical bus
(OptiConnect).</td>
</tr>
</table>
<p><strong>Network address.</strong> Internet address, in dotted decimal
notation, of the IP network or subnetwork to which the interface is
attached.</p>
<p><strong>Network address binary.</strong> Binary representation of the
network address.</p>
<p><strong>Network name.</strong> The first 10 characters of the name of the
network that this interface is a part of.</p>
<p><strong>Network name -
full.</strong> The complete 24 character name of the network that this
interface is a part of. </p>
<p><img src="delta.gif" alt="Start of change"><strong>Number of entries in
preferred interface list.</strong>
The number of entries in the preferred interface list. For virtual interfaces,
zero means that a preferred interface list is not being used.
For other types of interfaces, this field is set to zero.</p>
<p><strong>Offset to preferred interface list.</strong>
The offset from the start of the user space to the beginning of the preferred
interface list. For virtual interfaces, zero means that a preferred interface
list is not being used. For other types of interfaces, this field is set to
zero.<img src="deltaend.gif" alt="End of change"></p>
<p><strong>Packet rules.</strong> The kind of packet rules data available for a
particular line.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>-1</em></td>
<td align="left" valign="top">OTHER - An unknown Packet rules value.</td>
</tr>
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">None - No filters and no NAT are loaded for the
line specified.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">NAT - NAT is enabled for this line.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Filters - Filters are defined for this line.</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Filters and NAT - NAT enabled and filters
defined.</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">Filters and IPSec - Filters and IPSec filters are
defined for this line.</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">NAT and Filters and IPSec - NAT enabled and
Filters and IPsec filters defined.</td>
</tr>
</table>
<p><img src="delta.gif" alt="Start of change"><strong>Preferred interface list entry.</strong>
Specifies information about an interface in the preferred interface list.
The order in which the list entries are returned is also the order in which
the system uses the interfaces as Proxy Agents.</p>
<p><strong>Preferred interface internet address.</strong>
The internet address, in dotted decimal notation, of an interface in the
preferred interface list.</p>
<p><strong>Preferred interface internet address binary.</strong>
The binary representation of an interface internet address in the preferred
interface list.<img src="deltaend.gif" alt="End of change"></p>
<p><strong>Proxy ARP enabled.</strong> Whether Proxy ARP is currently active
for this interface. Proxy ARP allows physically distinct separate networks to
appear as if they are a single logical network. It provides connectivity
between physically separate network without creating any new logical networks
and without updating any route tables.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">NO - Proxy ARP not enabled.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">YES - Proxy ARP enabled.</td>
</tr>
</table>
<p><strong>Proxy ARP allowed.</strong> This field applies to Opticonnect (*OPC)
and Virtual interfaces only. For those types of interfaces, this field
indicates whether Proxy ARP has been configured to be allowed or not
allowed.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">NO - Proxy ARP not allowed.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">YES - Proxy ARP allowed.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Unsupported - Proxy ARP allowed field is not
supported by this interface.</td>
</tr>
</table>
<p><strong>Reserved.</strong> An ignored field.</p>
<p><strong>TRLAN bit sequencing.</strong> The order the Address Resolution
Protocol (ARP) puts bits into the hardware address for Token Ring. Possible
values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">MSB - The most significant bit is placed
first.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">LSB - The least significant bit is placed
first.</td>
</tr>
</table>
<br>
<h3><a name="NIFC0200">NIFC0200
Format</a></h3>
<p>The following information about each TCP/IPv6 logical interface is returned
for the NIFC0200 format. For detailed descriptions of the fields in the table,
see <a href="#NIFC0200_FIELD">Field Descriptions</a>.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">CHAR(45)</td>
<td align="left" valign="top" width="60%">Internet IPv6 address</td>
</tr>
<tr>
<td align="center" valign="top">45</td>
<td align="center" valign="top">2D</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Internet IPv6 address binary</td>
</tr>
<tr>
<td align="center" valign="top">64</td>
<td align="center" valign="top">40</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Interface prefix length</td>
</tr>
<tr>
<td align="center" valign="top">67</td>
<td align="center" valign="top">43</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">68</td>
<td align="center" valign="top">44</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Interface prefix length binary</td>
</tr>
<tr>
<td align="center" valign="top">72</td>
<td align="center" valign="top">48</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Address type</td>
</tr>
<tr>
<td align="center" valign="top">76</td>
<td align="center" valign="top">4C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Address state</td>
</tr>
<tr>
<td align="center" valign="top">80</td>
<td align="center" valign="top">50</td>
<td align="left" valign="top">BINARY(8)</td>
<td align="left" valign="top">Address preferred lifetime</td>
</tr>
<tr>
<td align="center" valign="top">88</td>
<td align="center" valign="top">58</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Address preferred lifetime expiration date</td>
</tr>
<tr>
<td align="center" valign="top">96</td>
<td align="center" valign="top">60</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Address preferred lifetime expiration time</td>
</tr>
<tr>
<td align="center" valign="top">102</td>
<td align="center" valign="top">66</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">104</td>
<td align="center" valign="top">68</td>
<td align="left" valign="top">BINARY(8)</td>
<td align="left" valign="top">Address valid lifetime</td>
</tr>
<tr>
<td align="center" valign="top">112</td>
<td align="center" valign="top">70</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Address valid lifetime expiration date</td>
</tr>
<tr>
<td align="center" valign="top">120</td>
<td align="center" valign="top">78</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Address valid lifetime expiration time</td>
</tr>
<tr>
<td align="center" valign="top">126</td>
<td align="center" valign="top">7E</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Line name</td>
</tr>
<tr>
<td align="center" valign="top">136</td>
<td align="center" valign="top">88</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Interface line type</td>
</tr>
<tr>
<td align="center" valign="top">140</td>
<td align="center" valign="top">8C</td>
<td align="left" valign="top">CHAR(50)</td>
<td align="left" valign="top">Interface description</td>
</tr>
<tr>
<td align="center" valign="top">190</td>
<td align="center" valign="top">BE</td>
<td align="left" valign="top">CHAR(45)</td>
<td align="left" valign="top">Network IPv6 address</td>
</tr>
<tr>
<td align="center" valign="top">235</td>
<td align="center" valign="top">EB</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">236</td>
<td align="center" valign="top">EC</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Network IPv6 address binary</td>
</tr>
<tr>
<td align="center" valign="top">252</td>
<td align="center" valign="top">FC</td>
<td align="left" valign="top">CHAR(45)</td>
<td align="left" valign="top">Host IPv6 address</td>
</tr>
<tr>
<td align="center" valign="top">297</td>
<td align="center" valign="top">129</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">300</td>
<td align="center" valign="top">12C</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Host IPv6 address binary</td>
</tr>
<tr>
<td align="center" valign="top">316</td>
<td align="center" valign="top">13C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Interface status</td>
</tr>
<tr>
<td align="center" valign="top">320</td>
<td align="center" valign="top">140</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Automatic start</td>
</tr>
<tr>
<td align="center" valign="top">324</td>
<td align="center" valign="top">144</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Packet rules</td>
</tr>
<tr>
<td align="center" valign="top">328</td>
<td align="center" valign="top">148</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Interface source</td>
</tr>
<tr>
<td align="center" valign="top">332</td>
<td align="center" valign="top">14C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Duplicate address detection transmits</td>
</tr>
<tr>
<td align="center" valign="top">336</td>
<td align="center" valign="top">150</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Multicast - number of references</td>
</tr>
<tr>
<td align="center" valign="top">340</td>
<td align="center" valign="top">154</td>
<td align="left" valign="top">CHAR(4)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">344</td>
<td align="center" valign="top">158</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Change date</td>
</tr>
<tr>
<td align="center" valign="top">352</td>
<td align="center" valign="top">160</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Change time</td>
</tr>
<tr>
<td align="center" valign="top">358</td>
<td align="center" valign="top">166</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top"><img src="delta.gif" alt="Start of change"> 360</td>
<td align="center" valign="top">168</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Interface description CCSID</td>
</tr>
<tr>
<td align="center" valign="top">364</td>
<td align="center" valign="top">16C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">MTU - configured</td>
</tr>
<tr>
<td align="center" valign="top">368</td>
<td align="center" valign="top">170</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">MTU - current</td>
</tr>
<tr>
<td align="center" valign="top">372</td>
<td align="center" valign="top">174</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Duplicate address detection maximum transmits</td>
</tr>
<tr>
<td align="center" valign="top">376</td>
<td align="center" valign="top">178</td>
<td align="left" valign="top">CHAR(50)</td>
<td align="left" valign="top">Alias name</td>
</tr>
<tr>
<td align="center" valign="top">426</td>
<td align="center" valign="top">1AA</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">432</td>
<td align="center" valign="top">1B0</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Alias Name CCSID<img src="deltaend.gif" alt="End of change"></td>
</tr>
<tr>
<td align="center" valign="top">436</td>
<td align="center" valign="top">1B4</td>
<td align="left" valign="top">&nbsp;</td>
<td align="left" valign="top">&nbsp;</td>
</tr>
</table>
<br>
<br>
<h3><a name="NIFC0200_FIELD"></a>Field Descriptions</h3>
<p><strong>Address preferred lifetime.</strong> The length of time that a
"valid" address is preferred, in seconds. When the preferred lifetime expires,
the address becomes Deprecated. See the Address State field description for
more information. Valid values range from 0 through 4294967295 seconds.
Negative values indicate that the Address preferred lifetime expired that
number of seconds ago.</p>
<p>The following are special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top" nowrap><em>-1000000000</em></td>
<td align="left" valign="top">Infinite - this address has an infinite preferred
lifetime.</td>
</tr>
<tr>
<td align="left" valign="top"><em>-1000000001</em></td>
<td align="left" valign="top">Not Applicable - this address is not in the
Preferred address state, so this field does not apply.</td>
</tr>
</table>
<p><strong>Address preferred lifetime expiration date.</strong> The date when
this address will no longer be preferred. If the Address preferred lifetime
expiration date and time are in the future, the address is still preferred. If
the Address preferred lifetime expiration date and time are in the past, then
this address is no longer preferred. The Address preferred lifetime expiration
date is returned as 8 characters in the form YYYYMMDD.</p>
<p>The meaning of the characters is as follows:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top">YYYY</td>
<td align="left" valign="top">Year</td>
</tr>
<tr>
<td align="left" valign="top">MM</td>
<td align="left" valign="top">Month</td>
</tr>
<tr>
<td align="left" valign="top">DD</td>
<td align="left" valign="top">Day</td>
</tr>
</table>
<p>The following are special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top" nowrap><em>00000000</em></td>
<td align="left" valign="top">Infinite - this address has an infinite preferred
lifetime which never expires.</td>
</tr>
<tr>
<td align="left" valign="top"><em>00000001</em></td>
<td align="left" valign="top">Not Applicable - this address is not in the
Preferred address state, so this field does not apply.</td>
</tr>
</table>
<p><strong>Address preferred lifetime expiration time.</strong> The time when
this address will no longer be in the preferred state. If the Address preferred
lifetime expiration date and time are in the future, the address is still
preferred. If the Address preferred lifetime expiration date and time are in
the past, then this address is no longer preferred. The Address preferred
lifetime expiration time is returned as 6 characters in the form HHMMSS.</p>
<p>The meaning of the characters is as follows:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top">HH</td>
<td align="left" valign="top">Hour</td>
</tr>
<tr>
<td align="left" valign="top">MM</td>
<td align="left" valign="top">Minute</td>
</tr>
<tr>
<td align="left" valign="top">SS</td>
<td align="left" valign="top">Second</td>
</tr>
</table>
<p>The following are special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>000000</em></td>
<td align="left" valign="top">Infinite - this address has an infinite preferred
lifetime which never expires.</td>
</tr>
<tr>
<td align="left" valign="top"><em>000001</em></td>
<td align="left" valign="top">Not Applicable - this address is not in the
preferred address state, so this field does not apply.</td>
</tr>
</table>
<p><strong>Address state.</strong> The current state of this IPv6 address. IPv6
addresses are in different states at different times, due to Duplicate Address
Detection (DAD) and address lifetimes. Unicast and Multicast addresses have
different possible states and the only state that applies to either type is
Failed.</p>
<p>When a unicast address is one of the two "valid" states, Preferred and
Deprecated, it may be used as the source or destination address of a packet.
When a unicast address is in one of the five "invalid" states it may not be
used as the source or destination address of a packet. The five "invalid"
states are: Tentative, Expired, Inactive, Duplicate and Failed.</p>
<p>When a multicast address is one of the two "valid" states, Idle Listener and
Delaying Listener, it may be used as the source or destination address of a
packet. When a multicast address is in one of the two "invalid" states,
Non-listener and Failed, it may not be used as the source or destination
address of a packet.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>-1</em></td>
<td align="left" valign="top">Failed - while attempting to move this address
from one state to another, an internal error occurred, preventing completion of
the action necessary to perform the state change.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Inactive - the interface has been ended by the
user and no further communications will be performed using this address. The
address is available to be reassigned elsewhere.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Duplicate - A duplicate address was detected on
the network during Duplicate Address Detection (DAD), therefore this address
was not moved to the Preferred state.</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Tentative - an address whose uniqueness on a link
is being verified, prior to its assignment to a physical interface. A tentative
address is not considered assigned to a physical interface in the usual sense.
A physical interface discards received packets addressed to a tentative
address, but accepts Neighbor Discovery packets related to Duplicate Address
Detection for the tentative address.</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">Preferred - an address assigned to a physical
interface whose use by upper layer protocols is unrestricted. Preferred
addresses may be used as the source (or destination) address of packets sent
from (or to) the physical interface.</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">Deprecated - an address assigned to a physical
interface whose use is discouraged, but not forbidden. A deprecated address
should no longer be used as a source address in new communications, but packets
sent from or to deprecated addresses are delivered as expected. A deprecated
address may continue to be used as a source address in communications where
switching to a preferred address causes hardship to a specific upper-layer
activity (for example, an existing TCP connection).</td>
</tr>
<tr>
<td align="left" valign="top"><em>6</em></td>
<td align="left" valign="top">Expired - an address assigned to a physical
interface whose use is forbidden. An address transitions to the expired state
when its valid lifetime expires. An IPv6 interface with an expired address will
be removed after a period of time.</td>
</tr>
<tr>
<td align="left" valign="top"><em>11</em></td>
<td align="left" valign="top">Non-listener - the initial state of a multicast
address when it first joins a multicast group and it is not yet listening for
any incoming Multicast Listener Discovery requests.</td>
</tr>
<tr>
<td align="left" valign="top"><em>12</em></td>
<td align="left" valign="top">Idle listener - this multicast interface is
listening for incoming Multicast Listener Discovery requests.</td>
</tr>
<tr>
<td align="left" valign="top"><em>13</em></td>
<td align="left" valign="top">Delaying listener - this multicast interface has
recieved an incoming Multicast Listener Discovery request and has gone to sleep
until it is time to wakeup and take action on that request.</td>
</tr>
</table>
<p><img src="delta.gif" alt="Start of change"><strong>Note:</strong>
As of V5R4, this field is no longer available and
will always be set to 4.<img src="deltaend.gif" alt="End of change"></p>
<p><strong>Address type.</strong> The type of IPv6 address that is assigned to
this network interface.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Unicast - an identifier for a single interface. A
packet sent to a unicast address is delivered to the interface identified by
that address.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Multicast - an identifier for a set of interfaces
(typically belonging to different nodes). A packet sent to a multicast address
is delivered to all interfaces identified by that address.</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Anycast - an identifier for a set of interfaces
(typically belonging to different nodes). A packet sent to an anycast address
is delivered to one of the interfaces identified by that address (the "nearest"
one, according to the routing protocols' measure of distance).</td>
</tr>
</table>
<p><strong>Address valid lifetime.</strong> The length of time, in seconds,
that an address remains in a "valid" state (Preferred or Deprecated). When the
valid lifetime expires, the address becomes Expired. See the Address State
field description for more information. Valid values range from 0
through 4294967295 seconds. Negative values indicate that the Address valid
lifetime expired that number of seconds ago.</p>
<p>The following are special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top" nowrap><em>-1000000000</em></td>
<td align="left" valign="top">Infinite - this address has an infinite valid
lifetime.</td>
</tr>
<tr>
<td align="left" valign="top"><em>-1000000001</em></td>
<td align="left" valign="top">Not Applicable - this address is not in a valid
address state, so this field does not apply.</td>
</tr>
</table>
<p><strong>Address valid lifetime expiration date.</strong> The date when this
address will expire or did expire. If the Address valid lifetime expiration
date and time are in the future, the address has not expired yet. If the
Address valid lifetime expiration date and time are in the past, then this
address has expired and is still being returned for a short period of time to
indicate that the interface ceased to function because its valid lifetime
expired. The Address valid lifetime expiration date is returned as 8 characters
in the form YYYYMMDD.</p>
<p>The meaning of the characters is as follows:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top">YYYY</td>
<td align="left" valign="top">Year</td>
</tr>
<tr>
<td align="left" valign="top">MM</td>
<td align="left" valign="top">Month</td>
</tr>
<tr>
<td align="left" valign="top">DD</td>
<td align="left" valign="top">Day</td>
</tr>
</table>
<p>The following are special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top" nowrap><em>00000000</em></td>
<td align="left" valign="top">Infinite - this address has an infinite valid
lifetime which never expires.</td>
</tr>
<tr>
<td align="left" valign="top"><em>00000001</em></td>
<td align="left" valign="top">Not Applicable - this address is not in a valid
address state, so this field does not apply.</td>
</tr>
</table>
<p><strong>Address valid lifetime expiration time.</strong> The time when this
address will expire or did expire. If the Address valid lifetime expiration
date and time are in the future, the address has not expired yet. If the
Address valid lifetime expiration date and time are in the past, then this
address has expired and is still being returned for a short period of time to
indicate that the interface ceased to function because its valid lifetime
expired. The Address valid lifetime expiration time is returned as 6 characters
in the form HHMMSS.</p>
<p>The meaning of the characters is as follows:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top">HH</td>
<td align="left" valign="top">Hour</td>
</tr>
<tr>
<td align="left" valign="top">MM</td>
<td align="left" valign="top">Minute</td>
</tr>
<tr>
<td align="left" valign="top">SS</td>
<td align="left" valign="top">Second</td>
</tr>
</table>
<p>The following are special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>000000</em></td>
<td align="left" valign="top">Infinite - this address has an infinite valid
lifetime which never expires.</td>
</tr>
<tr>
<td align="left" valign="top"><em>000001</em></td>
<td align="left" valign="top">Not Applicable - this address is not in a valid
address state, so this field does not apply.</td>
</tr>
</table>
<p><img src="delta.gif" alt="Start of change"> <strong>Alias Name.</strong>
Name given to interface to use as an alternate to the IP address.</p>
<p><strong>Alias Name CCSID.</strong> Coded character set ID for the alias
name.<img src="deltaend.gif" alt="End of change"></p>
<p><strong>Automatic start.</strong> Whether the interface is started
automatically when the TCP/IPv6 stack is activated. Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">NO. This interface is not started
automatically.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">YES. This interface is started
automatically.</td>
</tr>
</table>
<p><strong>Change date.</strong> The date of the most recent change to this
interface in the dynamic tables used by the TCP/IPv6 protocol stack. It is
returned as 8 characters in the form YYYYMMDD, where:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top">YYYY</td>
<td align="left" valign="top">Year</td>
</tr>
<tr>
<td align="left" valign="top">MM</td>
<td align="left" valign="top">Month</td>
</tr>
<tr>
<td align="left" valign="top">DD</td>
<td align="left" valign="top">Day</td>
</tr>
</table>
<p><strong>Change time.</strong> The time of the most recent change to this
interface in the dynamic tables used by the TCP/IPv6 protocol stack. It is
returned as 6 characters in the form HHMMSS, where:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top">HH</td>
<td align="left" valign="top">Hour</td>
</tr>
<tr>
<td align="left" valign="top">MM</td>
<td align="left" valign="top">Minute</td>
</tr>
<tr>
<td align="left" valign="top">SS</td>
<td align="left" valign="top">Second</td>
</tr>
</table>
<p><img src="delta.gif" alt="Start of change"><strong>Duplicate address
detection maximum transmits.</strong>
Specifies the maximum number of Duplicate Address Detection (DAD) transmissions
the stack will send out on the interface.<img src="deltaend.gif" alt="End of change"></p>
<p><strong>Duplicate address detection transmits.</strong> Specifies the number
of Duplicate Address Detection (DAD) transmissions the stack has sent out on
this interface.</p>
<p><img src="delta.gif" alt="Start of change"><strong>Note:</strong>
As of V5R4, this data is no longer available and is always set to 0.
<img src="deltaend.gif" alt="End of change"></p>
<p><strong>Host IPv6 address.</strong> Host portion of the internet address, in
IPv6 address format, as determined by the prefix length configured for this
interface. This field is NULL padded.</p>
<p><strong>Host IPv6 address binary.</strong> Binary representation of the host
IPv6 address. Even though this field is defined as a character field, a binary
IPv6 address is returned in it.</p>
<p><strong>Interface description</strong> Configured free form comment field
about this interface.</p>
<p><img src="delta.gif" alt="Start of change"><strong>Interface description CCSID.
</strong>Coded character set ID for the interface description field.
<img src="deltaend.gif" alt="End of change"></p>
<p><strong>Interface line type.</strong> Type of line used by the interface.
The following link protocols are supported:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>-1</em></td>
<td align="left" valign="top">OTHER</td>
</tr>
<tr>
<td align="left" valign="top"><em>-2</em></td>
<td align="left" valign="top">NONE - Line is not defined. This value is used
for the following interfaces: *LOOPBACK. There is no line
type value for this interface.</td>
</tr>
<tr>
<td align="left" valign="top"><em>-3</em></td>
<td align="left" valign="top">ERROR - This value is displayed if any system
errrors other than those for *NOTFND are received while trying to determine the
link type for an interface.</td>
</tr>
<tr>
<td align="left" valign="top"><em>-4</em></td>
<td align="left" valign="top">NOTFND - Not found. This value is displayed if
the line description object for this interface cannot be found.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">ELAN - Ethernet local area network protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">TRLAN - Token-ring local area network
protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">FR - Frame relay network protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">ASYNC - Asynchronous communications
protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">PPP - Point-to-point Protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>6</em></td>
<td align="left" valign="top">WLS - Wireless local area network protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>7</em></td>
<td align="left" valign="top">X.25 - X.25 protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>8</em></td>
<td align="left" valign="top">DDI - Distributed Data Interface protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>9</em></td>
<td align="left" valign="top">TDLC - Twinaxial Datalink Control. Used for
TCP/IP over Twinax.</td>
</tr>
<tr>
<td align="left" valign="top"><em>10</em></td>
<td align="left" valign="top">L2TP (Virtual PPP) - Layer Two Tunneling
Protocol.</td>
</tr>
<tr>
<td align="left" valign="top"><em>11</em></td>
<td align="left" valign="top">IPv6 Tunneling Line - Any kind of IPv6 over IPv4
tunnel.
<p><img src="delta.gif" alt="Start of change"><strong>Note:</strong>
As of V5R4, TRLAN, FR, ASYNC, PPP, WLS, X.25, DDI, TDLC, L2TP and IPv6 Tunneling
Line values are no longer supported.
<img src="deltaend.gif" alt="End of change"></p></td>
</tr>
</table>
<p><strong>Interface prefix length.</strong> The prefix length defines how many
bits of the interface IPv6 address are in the prefix. It is a zoned decimal
number which specifies how many of the left-most bits of the address make up
the prefix. The prefix length is used to generate network and host addresses.
This field is NULL padded.</p>
<p><strong>Interface prefix length binary.</strong> Binary representation of
the interface prefix length.</p>
<p><strong>Interface source</strong> Specifies how this interface was added to
the TCP/IPv6 stack.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Stateless - the interface was added to the stack
by the IPv6 stateless autoconfiguration mechanism.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Stateful - the interface was added to the stack
by the IPv6 stateful configuration mechanism (that is, DHCPv6).</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Manual - the interface was added to the stack by
manual configuration.</td>
</tr>
</table>
<p><strong>Interface status.</strong> Current status of this logical
interface.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Inactive - The interface has not been started.
The interface is not active.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Active - The interface has been started and is
running.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Starting - The system is processing the request
to start this interface.</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Ending - The system is processing the request to
end this interface.</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">RCYPND - An error with the physical line
associated with this interface was detected by the system. The line description
associated with this interface is in the recovery pending (RCYPND) state.</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">RCYCNL - A hardware failure has occurred and the
line description associated with this interface is in the recovery canceled
(RCYCNL) state.</td>
</tr>
<tr>
<td align="left" valign="top"><em>6</em></td>
<td align="left" valign="top">Failed - The line description associated with
this interface has entered the failed state.</td>
</tr>
<tr>
<td align="left" valign="top"><em>7</em></td>
<td align="left" valign="top">Failed (TCP) - An error was detected in the IBM
TCP/IP Vertical Licensed Internal Code.</td>
</tr>
</table>
<p><strong>Internet IPv6 address.</strong> The internet address, in IPv6
address format, of the interface.</p>
<p><strong>Internet IPv6 address binary.</strong> Binary representation of the
internet IPv6 address. Even though this field is defined as a character field,
a binary IPv6 address is returned in it.</p>
<p><strong>Line name.</strong> Name of the communications line description that
identifies the physical network associated with an interface. This field is
NULL padded.</p>
<p>The following are special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*LOOPBACK</em></td>
<td align="left" valign="top">This is the IPv6 loopback interface. Processing
associated with a loopback interface does not extend to a physical line.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*VIRTUALIP</em></td>
<td align="left" valign="top">The virtual interface is a circuitless interface.
It is used in conjunction with the associated local interface (LCLIFC) when
adding standard interfaces.
<p><img src="delta.gif" alt="Start of change"><strong>Note:</strong>
As of V5R4, this value is no longer supported.
<img src="deltaend.gif" alt="End of change"></p></td>
</tr>
<tr>
<td align="left" valign="top"><em>*OPC</em></td>
<td align="left" valign="top">This interface is attached to the optical bus
(OptiConnect).
<p><img src="delta.gif" alt="Start of change"><strong>Note:</strong>
As of V5R4, this value is no longer supported.
<img src="deltaend.gif" alt="End of change"></p></td>
</tr>
<tr>
<td align="left" valign="top"><em>*TNLCFG64</em></td>
<td align="left" valign="top">This interface is associated with a configured
6-4 tunneling line.
<p><img src="delta.gif" alt="Start of change"><strong>Note:</strong>
As of V5R4, this value is no longer supported.
<img src="deltaend.gif" alt="End of change"></p></td>
</tr>
</table>
<p><img src="delta.gif" alt="Start of change"><strong>MTU - configured.</strong>
The configured maximum transmission unit (MTU) value specified for this interface.</p>
<p>The following is a special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">LIND - The MTU was configured as *LIND, the MTU
size is the maximum frame size found in the line description object associated
with this interface.</td>
</tr>
</table>
<p><strong>MTU - current.</strong> Maximum transmission unit (MTU) value
currently in effect for this interface.</p>
<p>The following is a special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">LIND - The interface is not active currently and
the MTU was configured as *LIND.<img src="deltaend.gif" alt="End of change"> </td>
</tr>
</table>
<p><strong>Multicast - number of references.</strong> The number of Sockets
clients that have joined this multicast group.</p>
<p>The following is a special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>-1</em></td>
<td align="left" valign="top">This interface is not a Multicast address and
this field does not apply.</td>
</tr>
</table>
<p><img src="delta.gif" alt="Start of change"><strong>Note:</strong>
As of V5R4, this data is no longer available and is always set
to 0.<img src="deltaend.gif" alt="End of change"></p>
<p><strong>Network IPv6 address.</strong> Internet address, in IPv6 address
format, of the IPv6 network or subnetwork to which the interface is attached.
This field is NULL padded.</p>
<p><strong>Network IPv6 address binary.</strong> Binary representation of the
network IPv6 address. Even though this field is defined as a character field, a
binary IPv6 address is returned in it.</p>
<p><strong>Packet rules.</strong> The kind of packet rules data available for
the particular line this interface is associated with.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>-1</em></td>
<td align="left" valign="top">OTHER - An unknown Packet rules value.</td>
</tr>
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">None - No filters and no NAT are loaded for the
line specified.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">NAT - NAT is enabled for this line.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Filters - Filters are defined for this line.</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Filters and NAT - NAT enabled and filters
defined.</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">Filters and IPSec - Filters and IPSec filters are
defined for this line.</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">NAT and Filters and IPSec - NAT enabled and
Filters and IPsec filters defined.</td>
</tr>
</table>
<p><strong>Reserved.</strong> An ignored field.</p>
<br>
<h3>Error Messages</h3>
<table width="100%" cellpadding="5">
<!-- cols="15 85" -->
<tr>
<th align="left" valign="top">Message ID</th>
<th align="left" valign="top">Error Message Text</th>
</tr>
<tr>
<td width="15%" valign="top">TCP84C0 E</td>
<td width="85%" valign="top">TCP/IP stack not active.</td>
</tr>
<tr>
<td align="left" valign="top">TCP84C5 E</td>
<td align="left" valign="top">API error listing TCP/IP Network Status list
information.</td>
</tr>
<tr>
<td align="left" valign="top">TCP84C6 E</td>
<td align="left" valign="top">Internal operations error - RESULT &amp;1 CC
&amp;2 RC &amp;3 ERRNO &amp;4.</td>
</tr>
<tr>
<td align="left" valign="top">TCP84C9 I</td>
<td align="left" valign="top">Information returned incomplete.</td>
</tr>
<tr>
<td align="left" valign="top">CPF0F03 E</td>
<td align="left" valign="top">Error in retrieving the user space that was
created by the caller.</td>
</tr>
<tr>
<td align="left" valign="top">CPF24B4 E</td>
<td align="left" valign="top">Severe error while addressing parameter
list.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C1E E</td>
<td align="left" valign="top">Required parameter &amp;1 omitted.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C21 E</td>
<td align="left" valign="top">Format name &amp;1 is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3CF1 E</td>
<td align="left" valign="top">Error code parameter not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3CF2 E</td>
<td align="left" valign="top">API contains a problem. See prior messages to
determine why the failure occurred.</td>
</tr>
<tr>
<td align="left" valign="top">CPF8100 E</td>
<td align="left" valign="top">All CPF81xx messages could be returned. xx is
from 01 to FF.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9801 E</td>
<td align="left" valign="top">Object &amp;2 in library &amp;3 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9802 E</td>
<td align="left" valign="top">Not authorized to object &amp;2 in &amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9803 E</td>
<td align="left" valign="top">Cannot allocate object &amp;2 in library
&amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9807 E</td>
<td align="left" valign="top">One or more libraries in library list
deleted.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9808 E</td>
<td align="left" valign="top">Cannot allocate one or more libraries on library
list.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9810 E</td>
<td align="left" valign="top">Library &amp;1 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9820 E</td>
<td align="left" valign="top">Not authorized to use library &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9830 E</td>
<td align="left" valign="top">Cannot assign library &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9872 E</td>
<td align="left" valign="top">Program or service program &amp;1 in library
&amp;2 ended. Reason code &amp;3.</td>
</tr>
</table>
<br>
<hr>
API introduced: V5R1
<hr>
<center>
<table cellpadding="2" cellspacing="2" align="center">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"comm.htm">Communications APIs</a> | <a href="aplist.htm">APIs by category</a>
</td>
</tr>
</table></center>
</body>
</html>
Reference in New Issue Copy Permalink