ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaef_5.4.0.1/rzaefapiconsiderations.htm

142 lines
6.4 KiB
HTML

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="dc.language" scheme="rfc1766" content="en-us" />
<!-- 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. -->
<meta name="dc.date" scheme="iso8601" content="2005-09-06" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2000, 2006" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow"/>
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="keywords" content="using on QNetWare file system, APIs,
Integrated File System, using Integrated File System APIs, QNetWare file system" />
<title>Considerations for using integrated file system APIs on the QNetWare file system</title>
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
<link rel="stylesheet" type="text/css" href="ic.css" />
</head>
<body>
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
<a name="apiconsiderations"></a>
<h3 id="apiconsiderations">Considerations for using integrated file system APIs on the QNetWare file system</h3><a id="idx248" name="idx248"></a><a id="idx249" name="idx249"></a>
<p>In addition to the Integrated File System commands and menus, i5/OS provides APIs that
enable ILE C for iSeries&trade; programs to perform functions on files and directories
in all file systems. The Integrated File System APIs are very useful for integrating the iSeries database with NetWare Enhanced Integration data. You can find information about ILE and ILE
C for iSeries in the book <a href="../books/sc415606.pdf" target="_blank">ILE Concepts,
SC41-5606</a>
<img src="wbpdf.gif" alt="Link to PDF" />.</p>
<p>When you use Integrated File System APIs on the QNetWare file system, you need to know that these C language
functions are not supported on the QNetWare file system: </p>
<a name="wq111"></a>
<table id="wq111" width="100%" summary="" border="0" frame="void" rules="none" class="singleborder">
<thead valign="bottom">
<tr valign="bottom">
<th id="wq112" width="27%" align="left">APIs</th>
<th id="wq113" width="72%" align="left">Description</th>
</tr>
</thead>
<tbody valign="top">
<tr>
<td align="left" valign="top" headers="wq112">givedescriptor()</td>
<td align="left" valign="top" headers="wq113">Give file access to another job</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq112">link()</td>
<td align="left" valign="top" headers="wq113">Create link to file</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq112">readlink()</td>
<td align="left" valign="top" headers="wq113">Read value of symbolic link</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq112">symlink()</td>
<td align="left" valign="top" headers="wq113">Make symbolic link</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq112">takedescriptor()</td>
<td align="left" valign="top" headers="wq113">Take file access from another job</td>
</tr>
</tbody>
</table>
<p>In addition to the previous APIs, you cannot use the following APIs against
NDS objects, servers, or volumes:</p>
<a name="wq114"></a>
<table id="wq114" width="100%" summary="" border="0" frame="void" rules="none" class="singleborder">
<thead valign="bottom">
<tr>
<th id="wq115" width="27%" align="left">APIs</th>
<th id="wq116" width="72%" align="left">Description</th>
</tr>
</thead>
<tbody valign="top">
<tr>
<td align="left" valign="top" headers="wq115">chmod()</td>
<td align="left" valign="top" headers="wq116">Change file authorizations</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq115">chown()</td>
<td align="left" valign="top" headers="wq116">Change owner and group of file</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq115">create()</td>
<td align="left" valign="top" headers="wq116">Create new file or rewrite existing file</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq115">fchmod()</td>
<td align="left" valign="top" headers="wq116">Change file authorizations by descriptor</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq115">fchown()</td>
<td align="left" valign="top" headers="wq116">Change owner and group of file by descriptor</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq115">fcntl()</td>
<td align="left" valign="top" headers="wq116">Perform file control action</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq115">ftruncate()</td>
<td align="left" valign="top" headers="wq116">Truncate file</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq115">lseek()</td>
<td align="left" valign="top" headers="wq116">Set file read/write offset</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq115">mkdir()</td>
<td align="left" valign="top" headers="wq116">Make directory</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq115">read()</td>
<td align="left" valign="top" headers="wq116">Read from file</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq115">readv()</td>
<td align="left" valign="top" headers="wq116">Read from file (vector)</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq115">unmask()</td>
<td align="left" valign="top" headers="wq116">Set authorization mask for job</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq115">write()</td>
<td align="left" valign="top" headers="wq116">Write to file</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq115">writev()</td>
<td align="left" valign="top" headers="wq116">Write to file (vector)</td>
</tr>
</tbody>
</table>
<p>You can see an <a href="rzaefqlspgmx.htm#qlspgmx">example program</a> that copies an iSeries database file to QNetWare File System.</p>
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
</body>
</html>