ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/QFVLSTNL.htm

512 lines
16 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>List Node List Entries (QFVLSTNL) 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. -->
<!-- COMM4 SCRIPT A converted by B2H R4.1 (346) (CMS) by V2DCIJB at -->
<!-- RCHVMW2 on 1 Jun 1999 at 17:32:50 -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!--File Edited December, 2001 =========================================== -->
<!--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 Node List Entries (QFVLSTNL) API</h2>
<div class="box" style="width: 70%;">
<br>
&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">Qualified node list name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(20)</td>
</tr>
<tr>
<td align="center" valign="top">4</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;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: No<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The List Node List Entries (QFVLSTNL) API returns, in a user space, a list of the nodes contained in the specified node list object.</p>
<br>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>Node List Object Authority</em></dt>
<dd>*USE<br><br></dd>
<dt><em>Node List Object Lock</em></dt>
<dd>*SHRRD<br><br></dd>
<dt><em>User Space Authority</em></dt>
<dd>*CHANGE<br><br></dd>
<dt><em>User Space Library Authority</em></dt>
<dd>*EXECUTE<br><br></dd>
<dt><em>User Space Lock</em></dt>
<dd>*EXCLRD</dd>
</dl>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Qualified user space name</strong></dt>
<dd><em>INPUT; CHAR (20)</em>
<p>The name of the user space that is to receive the generated list. The first 10 characters contain the user space name. The second 10 characters contain the name of the library where the user space is located.</p>
<p>The following special values can be used for the library name:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*CURLIB</em></td>
<td valign="top">The current library.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LIBL</em></td>
<td valign="top">The library list.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Format name</strong></dt>
<dd>INPUT; CHAR(8)
<p>The format of the data placed in the user space. The valid value is:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>NODL0100</em></td>
<td valign="top">All node list entry information returned. This format is explained in <a href="#HDRLSTDATA">NODL0100 List Data Section</a>.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Qualified node list name</strong></dt>
<dd>INPUT; CHAR(20)
<p>The name of the node list object from which the entries are to be retrieved. The first 10 characters contain the node list name. The second 10 characters contain the name of the library where the node list is located.</p>
<p>Special values for the name of the node list library are:</p>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*CURLIB</em></td>
<td valign="top">The current library.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LIBL</em></td>
<td valign="top">The library list.</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>
<h3>Format of the Generated Lists</h3>
<p>The returned user space will contain:</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</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 other items, see the following sections. For a detailed description of each field in the information returned, see <a href="#HDRFIELDEF">Field Descriptions</a>.</p>
<br>
<h3>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" width="10%">10</td>
<td align="center" valign="top" width="10%">A</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">User space library name specified</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(8)</td>
<td align="left" valign="top" width="60%">Format name specified</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">28</td>
<td align="center" valign="top" width="10%">1C</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Node list object name specified</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">38</td>
<td align="center" valign="top" width="10%">26</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Node list object library name specified</td>
</tr>
</table>
<br><br>
<h3>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" width="10%">10</td>
<td align="center" valign="top" width="10%">A</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">User space library name used</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(10)</td>
<td align="left" valign="top" width="60%">Node list object name used</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">30</td>
<td align="center" valign="top" width="10%">1E</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Node list object library name used</td>
</tr>
</table>
<br><br>
<h3><a name="HDRLSTDATA">NODL0100 List Data Section</a></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(1)</td>
<td align="left" valign="top" width="60%">Address type</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">1</td>
<td align="center" valign="top" width="10%">1</td>
<td align="left" valign="top" width="20%">CHAR(20)</td>
<td align="left" valign="top" width="60%">Remote location name (for address type
1)</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">21</td>
<td align="center" valign="top" width="10%">15</td>
<td align="left" valign="top" width="20%">CHAR(50)</td>
<td align="left" valign="top" width="60%">Text description</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">71</td>
<td align="center" valign="top" width="10%">47</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%">72</td>
<td align="center" valign="top" width="10%">48</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Text description CCSID</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">76</td>
<td align="center" valign="top" width="10%">4C</td>
<td align="left" valign="top" width="20%">CHAR(256)</td>
<td align="left" valign="top" width="60%">Remote location name (for address type 1, 2, or 3)</td>
</tr>
</table>
<br><br>
<h3><a name="HDRFIELDEF">Field Descriptions</a></h3>
<p><strong>Address type.</strong> The type of address returned. The following values are used:</p>
<table cellpadding="3">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td valign="top">SNA APPN address type. The network ID and control point name are given in both the remote location name field at offset 1 and at offset 76.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td valign="top">Internet protocol (IP) address type. The host name is given in the remote location name field at offset 76.</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td valign="top">Internet protocol (IP) address type. The internet address is given in the remote location name field at offset 76.</td>
</tr>
</table>
<p><strong>Format name specified.</strong> The format name specified as input for the API.</p>
<p><strong>Node list object library name specified.</strong> The name of the node list object library as specified on the call to the API.</p>
<p><strong>Node list object library name used.</strong> The actual name of the node list object library used to report data.</p>
<p><strong>Node list object name specified.</strong> The node list object name as specified on the call to the API. Nodes with an SNA address type are identified by a network ID and a control point name. Nodes with an internet protocol (IP) type are identified by a host name or an internet address. The system-recognized identifier for the object type is *NODL.</p>
<p><strong>Node list object name used.</strong> The actual node list object name used to report data. The system-recognized identifier for the object type is *NODL.</p>
<p><strong>Remote location name (for address type x).</strong> The name of a system in a network.</p>
<p>The remote location name field at offset 1 contains an 8-character SNA network ID, an 8-character control point name, and 4 reserved characters. The remote location name field at offset 1 is only used if the address type is 1 (SNA). Otherwise, the field at offset 1 is blank.</p>
<p>The contents of the remote location name field at offset 76 depends on the address type:</p>
<table cellpadding="3">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td valign="top">Contains the same name as the field at offset 1: an 8-character SNA network ID, an 8-character control point name, and 4 reserved characters.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td valign="top">Contains a 255-character host name and 1 reserved character.</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td valign="top">Contains a 15-character internet address and 241 reserved characters.</td>
</tr>
</table>
<p><strong>Reserved.</strong> An ignored field.</p>
<p><strong>Text description.</strong> The text description of the node list entry.</p>
<p><strong>Text description CCSID.</strong> The coded character set identifier (CCSID) used for the text description.</p>
<p><strong>User space library name specified.</strong> The user space library name as specified on the call to the API.</p>
<p><strong>User space library name used.</strong> The actual user space library name used to report data.</p>
<p><strong>User space name specified.</strong> The user space name as specified on the call to the API.</p>
<p><strong>User space name used.</strong> The actual user space name used to report data.</p>
<br>
<h3>Error Messages</h3>
<table width="100%" cellpadding="3">
<!-- cols="15 85" -->
<tr>
<th align="left" valign="top">Message ID</th>
<th align="left" valign="top">Error Message Text</th>
</tr>
<tr>
<td align="left" valign="top">CPF24B4 E</td>
<td valign="top">Severe error while addressing parameter list.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C21 E</td>
<td valign="top">Format name &amp;1 is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C90 E</td>
<td valign="top">Literal value cannot be changed.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3CF1 E</td>
<td valign="top">Error code parameter not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF813E E</td>
<td valign="top">Node list &amp;4 in &amp;9 damaged.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9801 E</td>
<td valign="top">Object &amp;2 in library &amp;3 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9802 E</td>
<td valign="top">Not authorized to object &amp;2 in &amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9803 E</td>
<td valign="top">Cannot allocate object &amp;2 in library &amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9807 E</td>
<td valign="top">One or more libraries in library list deleted.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9808 E</td>
<td valign="top">Cannot allocate one or more libraries on library list.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9810 E</td>
<td valign="top">Library &amp;1 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9820 E</td>
<td valign="top">Not authorized to use library &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9830 E</td>
<td valign="top">Cannot assign library &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9838 E</td>
<td valign="top">User profile storage limit exceeded.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9872 E</td>
<td valign="top">Program or service program &amp;1 in library &amp;2 ended. Reason code &amp;3.</td>
</tr>
</table>
<br>
<hr>
API introduced: V2R3
<hr>
<center>
<table cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a
href="netmg.htm">Network Management APIs</a> | <a href="aplist.htm">APIs
by category</a></td>
</tr>
</table>
</center>
</body>
</html>