351 lines
13 KiB
HTML
351 lines
13 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
|
<title>List SNADS File Server Object Access IDs (QZDLSTID) 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. -->
|
|
<!-- NETMG2 SCRIPT A converted by B2H R4.1 (346) (CMS) by HOLTJM at -->
|
|
<!-- RCHVMW2 on 29 Jan 1999 at 10:01:37 -->
|
|
<!--File Edited October 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 language="Javascript" src ="../rzahg/synch.js" type="text/javascript"></script>
|
|
|
|
<h2>List SNADS File Server Object Access IDs (QZDLSTID) API</h2>
|
|
|
|
<div class="box" style="width: 65%;">
|
|
<br>
|
|
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">Product ID</td>
|
|
<td align="LEFT" valign="TOP">Input</td>
|
|
<td align="LEFT" valign="TOP">Char(7)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="LEFT" valign="TOP">Continuation access ID</td>
|
|
<td align="LEFT" valign="TOP">Input</td>
|
|
<td align="LEFT" valign="TOP">Char(8)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">5</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>
|
|
Default Public Authority: *EXCLUDE<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Threadsafe: No<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
</div>
|
|
|
|
<p>The List SNADS File Server Object Access IDs (QZDLSTID) API can be used to list the current accesses owned by the specified product. Each access ID represents an access done on a file server object (FSO) that was obtained by using the Assign SNADS File Server Object Access ID (QZDASNID) API. The list of access IDs is returned in a user space.</p>
|
|
|
|
<p>This API provides a way for an application to do cleanup. For example, if the assigned access IDs that are stored are lost, you can use this API to find out what access IDs need to be revoked. An application should use this list interface at some periodic interval to check if it has any assigned access IDs that were not revoked.</p>
|
|
|
|
<p>If you use the MSF product ID (QMSFPRD) on the QZDASNID API, you do not have to use this API for cleanup purposes. Cleanup routines currently exist in the system to revoke access IDs assigned to the MSF product. These cleanup routines revoke access IDs only when the IDs are no longer associated with any file server object.</p>
|
|
|
|
<p>The continuation access ID parameter should be either set to nulls (X'00') to have this API start the search at the beginning of all access IDs, or set to a specific access ID. For the latter, the QZDLSTID API starts searching with the next greater access ID. (No error is returned if the starting access ID does not exist.) If more access IDs exist for a product than were returned on the call to the QZDLSTID API, this API sets the information status variable in the generic user space header to indicate partially complete information. To retrieve more access IDs, the caller should use the continuation access ID as input for the next call to the QZDLSTID API.</p>
|
|
|
|
<br>
|
|
<h3>Authorities and Locks</h3>
|
|
|
|
<dl>
|
|
<dt><em>API Public Authority</em></dt>
|
|
<dd>*EXCLUDE</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
<h3>Required Parameter Group</h3>
|
|
|
|
<dl>
|
|
<dt><strong>User space name</strong></dt>
|
|
<dd>INPUT; CHAR(20)
|
|
|
|
<p>The user space that stores all the access IDs found. This structure contains the user space name and the library name where the user space is defined. The first 10 characters contain the user space name, and the second 10 characters contain the library name.</p></dd>
|
|
|
|
<dt><strong>Format name</strong></dt>
|
|
<dd>INPUT; CHAR(8)
|
|
|
|
<p>The name of the format that returns access ID information. You can specify this format:</p>
|
|
|
|
<table cellpadding="3">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td valign="top"><em>ACID0100</em></td>
|
|
<td valign="top">Each entry contains an access ID.</td>
|
|
</tr>
|
|
</table>
|
|
<br></dd>
|
|
|
|
<dt><strong>Product ID</strong></dt>
|
|
<dd>INPUT; CHAR(7)
|
|
|
|
<p>The identifier of the product that is using the QZDLSTID API. This parameter is necessary to group access IDs by product and to facilitate better cleanup of file server objects. For example, an installed product that was creating FSOs is removed from the system, but FSOs still exist that are referred to by that product. The SNADS cleanup routines check to ensure that the product is installed, and if the product was removed, the SNADS cleanup routines delete the remaining FSOs referred to by that product.</p>
|
|
|
|
<p>Valid values for this parameter are as follows:</p>
|
|
|
|
<table cellpadding="3">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td valign="top"><em>Product ID</em></td>
|
|
<td valign="top">The product ID of a product that is installed on the iSeries server.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>QMSFPRD</em></td>
|
|
<td valign="top">The MSF product identifier. This value can be used for all file server objects that are referred to by the MSF messages.</td>
|
|
</tr>
|
|
</table>
|
|
<br></dd>
|
|
|
|
<dt><strong>Continuation access ID</strong></dt>
|
|
<dd>INPUT; CHAR(8)
|
|
|
|
<p>The identifier that is used together with the product ID to identify the first file server object access to find. You can determine if a previous call resulted in partially complete information by checking the information status variable in the generic user-space header following the API call.</p>
|
|
|
|
<p>If the API is not attempting to continue from a previous call, this parameter must be set to hexadecimal zeros. Otherwise, a valid continuation value must be supplied. The value may be obtained from the list header section of the user space used in the previous call. When continuing, the first entry in the returned list is the entry that immediately follows the last entry returned in the previous call.</p></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 User Space Variables</h3>
|
|
|
|
<p>The following tables describe the order and format of the data returned in the user space.</p>
|
|
|
|
<br>
|
|
<h3><a name="HDRUSERSPC">Input Parameter 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(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</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="CENTER" valign="TOP">28</td>
|
|
<td align="CENTER" valign="TOP">1C</td>
|
|
<td align="LEFT" valign="TOP">CHAR(7)</td>
|
|
<td align="LEFT" valign="TOP">Product ID</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="CENTER" valign="TOP">35</td>
|
|
<td align="CENTER" valign="TOP">23</td>
|
|
<td align="LEFT" valign="TOP">CHAR(8)</td>
|
|
<td align="LEFT" valign="TOP">Continuation access ID</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br><br>
|
|
<h3><a name="HDRHEAD">Header 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(8)</td>
|
|
<td align="left" valign="top" width="60%">Continuation access ID</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br><br>
|
|
<h3><a name="HDRLISTAC">ACID0100 Format</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(8)</td>
|
|
<td align="left" valign="top" width="60%">Access ID</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br><br>
|
|
<h3><a name="HDRUSERD">Field Descriptions</a></h3>
|
|
|
|
<p><strong>Access ID.</strong> Each entry in the returned list contains an access ID that is currently assigned to the product specified on input.</p>
|
|
|
|
<p><strong>Continuation access ID (header section).</strong> A continuation point for the API. This value is set based on the contents of the information status variable in the generic header for the user space. The following situations can occur for the following information statuses:</p>
|
|
|
|
<table cellpadding="3">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td valign="top"><em>C</em></td>
|
|
<td valign="top">The information returned in the user space is valid and complete. No continuation is necessary and the continuation access ID is set to nulls (X'00').</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>P</em></td>
|
|
<td valign="top">The information returned in the user space is valid but incomplete. The user may call the API again, starting where the last call left off. The continuation access ID contains a value, which may be supplied as an input parameter in later calls.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>I</em></td>
|
|
<td valign="top">The information returned in the user space is not valid and not complete. The content of the continuation access ID is unpredictable.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Continuation access ID (input section).</strong> The identifier that is used to continue from a previous call to this API, which resulted in partially complete information.</p>
|
|
|
|
<p><strong>Format name.</strong> The name of the format used to return access ID information.</p>
|
|
|
|
<p><strong>Product ID.</strong> The identifier of the product that is using the QZDLSTID API.</p>
|
|
|
|
<p><strong>User space library name specified.</strong> The name of the library that contains the user space.</p>
|
|
|
|
<p><strong>User space name specified.</strong> The name of the user space to which the list of access IDs is returned.</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">CPF3A09 E</td>
|
|
<td valign="top">System error.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3A12 E</td>
|
|
<td valign="top">Interface error.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3A13 E</td>
|
|
<td valign="top">Access ID 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">CPF9872 E</td>
|
|
<td valign="top">Program or service program &1 in library &2 ended. Reason code &3.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
<hr>
|
|
API Introduced: V3R6
|
|
|
|
<hr>
|
|
<table cellpadding="2" cellspacing="2" align="center">
|
|
<tr align="center">
|
|
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a
|
|
href="off1a.htm">Office APIs</a> | <a href=
|
|
"aplist.htm">APIs by category</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
</body>
|
|
</html>
|