172 lines
12 KiB
HTML
172 lines
12 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 lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<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="DC.Type" content="reference" />
|
|
<meta name="DC.Title" content="iSeries Access for Windows Directory Update APIs" />
|
|
<meta name="abstract" content="The iSeries Access for Windows Directory Update function allows users to specify PC directories for updating from a configured network server or from multiple networked servers. This permits users to load non-iSeries Access for Windows software products on a server in the network, and to keep those files updated on PCs. Directory Update is an optionally installable iSeries Access for Windows component." />
|
|
<meta name="description" content="The iSeries Access for Windows Directory Update function allows users to specify PC directories for updating from a configured network server or from multiple networked servers. This permits users to load non-iSeries Access for Windows software products on a server in the network, and to keep those files updated on PCs. Directory Update is an optionally installable iSeries Access for Windows component." />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikapiinterfaces.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikuftypuse.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikrequiredduentries.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikoptionalduentries.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikdupkgfilelayout.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikufunderstand.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikufapilist1.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikufapilist2.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikufapilist3.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikufapilist4.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikufapilist5.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikrcufapis.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikas400sysnameformat.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaikcaexpressprogstd.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1999, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1999, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="updatex" />
|
|
<meta name="DC.Language" 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. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>iSeries Access for Windows Directory
|
|
Update APIs</title>
|
|
</head>
|
|
<body id="updatex"><a name="updatex"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1"><span class="keyword">iSeries Access for Windows</span> Directory
|
|
Update APIs</h1>
|
|
<div><p>The <span class="keyword">iSeries™ Access for Windows<sup>®</sup></span> Directory
|
|
Update function allows users to specify PC directories for updating from a
|
|
configured network server or from multiple networked servers. This permits
|
|
users to load non-<span class="keyword">iSeries Access for Windows</span> software
|
|
products on a server in the network, and to keep those files updated on PCs.
|
|
Directory Update is an optionally installable <span class="keyword">iSeries Access for Windows</span> component.</p>
|
|
<div class="section"><h4 class="sectiontitle">How to install <span class="keyword">iSeries Access for Windows</span> Directory
|
|
Update:</h4><p>To install Directory Update, follow these steps when you
|
|
install <span class="keyword">iSeries Access for Windows</span>, or when
|
|
you run Selective Setup if <span class="keyword">iSeries Access for Windows</span> is
|
|
already installed:</p>
|
|
<ol><li>Select the <span class="uicontrol"><span class="keyword">iSeries Access for Windows</span> Optional
|
|
Components</span> check box.</li>
|
|
<li>Expand the view and make sure that the <span class="uicontrol">Directory Update</span> subcomponent
|
|
also is selected.</li>
|
|
<li>Follow the prompts to completion.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle"><span class="keyword">iSeries Access for Windows</span> Directory
|
|
Update C/C++ APIs:</h4><span class="keyword">iSeries Access for Windows</span> Directory
|
|
Update C/C++ application programming interfaces (APIs) allow software developers
|
|
to add, change and delete update entries that are used by the <span class="keyword">iSeries Access for Windows</span> Directory
|
|
Update function. <div class="note"><span class="notetitle">Note:</span> <span class="keyword">iSeries Access for Windows</span> Directory
|
|
Update APIs do not actually perform the updates. They are for configuration
|
|
purposes only. The task of updating files is handled exclusively by the Directory
|
|
Update application.</div>
|
|
<p><span class="keyword">iSeries Access for Windows</span> Directory
|
|
Update APIs enable the:</p>
|
|
<ul><li>Creation of update entries.</li>
|
|
<li>Deletion of update entries.</li>
|
|
<li>Modification of update entries.</li>
|
|
<li>Retrieval of information from update entries.</li>
|
|
<li>Retrieval of information such as return codes. For example, only one application
|
|
can access the Update entries at a time. If you get a return code that indicates <strong>locked</strong>,
|
|
use the information to find the name of the application that has the entries
|
|
open.</li>
|
|
</ul>
|
|
</div>
|
|
<div class="section"> <div class="note"><span class="notetitle">IMPORTANT:</span> The <span class="keyword">iSeries Access for Windows</span> client
|
|
does not include support for network drives or for universal naming conventions.
|
|
This now is provided by the <strong>iSeries NetServer</strong> function. Network
|
|
drives that you previously mapped by using iSeries Access should be mapped by using iSeries NetServer
|
|
support. Set up the iSeries NetServer that comes with OS/400<sup>®</sup> V4R2
|
|
and beyond in order to perform file serving to the iSeries server. <dl><dt class="dlterm">NetServer information resources:</dt>
|
|
<dd> <ul><li><a href="../rzahl/rzahlusergoal.htm">iSeries NetServer</a> topic
|
|
of the iSeries Information
|
|
Center</li>
|
|
<li>IBM<sup>®</sup> <a href="http://www.ibm.com/eserver/iseries/netserver">iSeries NetServer
|
|
Home Page</a><img src="www.gif" alt="Link outside the Information Center" /></li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle"><span class="keyword">iSeries Access for Windows</span> Directory
|
|
Update APIs required files:</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="25.862068965517242%" id="d0e213">Header file</th>
|
|
<th valign="top" width="30.344827586206897%" id="d0e215">Import library</th>
|
|
<th valign="top" width="43.79310344827586%" id="d0e217">Dynamic Link Library</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr><td valign="top" width="25.862068965517242%" headers="d0e213 ">cwbup.h</td>
|
|
<td valign="top" width="30.344827586206897%" headers="d0e215 ">cwbapi.lib</td>
|
|
<td valign="top" width="43.79310344827586%" headers="d0e217 ">cwbup.dll</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Programmer's Toolkit:</h4><p>The Programmer's Toolkit provides
|
|
Directory Update documentation, access to the cwbup.h header file, and links
|
|
to sample programs. To access this information, open the Programmer's Toolkit
|
|
and select <span class="menucascade"><span class="uicontrol">Directory Update</span> > <span class="uicontrol">C/C++
|
|
APIs</span></span>. </p>
|
|
<div class="note"><span class="notetitle">Note:</span> By using the code examples, you
|
|
agree to the terms of the <a href="codedisclaimer.htm">Code license and disclaimer information</a>.</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<ul class="ullinks">
|
|
<li class="ulchildlink"><strong><a href="rzaikuftypuse.htm">Typical use of iSeries Access for Windows Directory Update APIs</a></strong><br />
|
|
<span class="keyword">iSeries Access for Windows</span> Directory
|
|
Update APIs typically are used for creating and configuring update entries
|
|
that are used to update files from a mapped network drive. It is important
|
|
to note that the Update APIs do not actually update the files, but rely on
|
|
the Directory Update executable file to do this.</li>
|
|
<li class="ulchildlink"><strong><a href="rzaikrequiredduentries.htm">Requirements for Directory Update entries</a></strong><br />
|
|
The following are required for Directory Update entries.</li>
|
|
<li class="ulchildlink"><strong><a href="rzaikoptionalduentries.htm">Options for Directory Update entries</a></strong><br />
|
|
The following are optional for Directory Update entries:</li>
|
|
<li class="ulchildlink"><strong><a href="rzaikdupkgfilelayout.htm">Directory Update package files syntax and format</a></strong><br />
|
|
<strong>Package files</strong> contain information that specifies and describes
|
|
which target files users want to be kept current with source files. </li>
|
|
<li class="ulchildlink"><strong><a href="rzaikufunderstand.htm">Directory Update sample program</a></strong><br />
|
|
For a Directory Update C/C++ sample program, you can go to the Programmer's Toolkit - Directory Update Web page.</li>
|
|
<li class="ulchildlink"><strong><a href="rzaikufapilist1.htm">Directory Update: Create and delete APIs</a></strong><br />
|
|
The following <span class="keyword">iSeries Access for Windows</span> Directory
|
|
Update are used to create and delete an update entry. The APIs are listed
|
|
alphabetically.</li>
|
|
<li class="ulchildlink"><strong><a href="rzaikufapilist2.htm">Directory Update: Access APIs</a></strong><br />
|
|
The following <span class="keyword">iSeries Access for Windows</span> Directory
|
|
Update are used to obtain access to an update entry. The APIs are listed alphabetically.</li>
|
|
<li class="ulchildlink"><strong><a href="rzaikufapilist3.htm">Directory Update: Free Resources APIs</a></strong><br />
|
|
The following <span class="keyword">iSeries Access for Windows</span> Directory
|
|
Update are used to free resources that are associated with an entry handle.
|
|
The APIs are listed alphabetically.</li>
|
|
<li class="ulchildlink"><strong><a href="rzaikufapilist4.htm">Directory Update: Change APIs</a></strong><br />
|
|
The following <span class="keyword">iSeries Access for Windows</span> Directory
|
|
Update are used to change an update entry. The APIs are listed
|
|
alphabetically.</li>
|
|
<li class="ulchildlink"><strong><a href="rzaikufapilist5.htm">Directory Update: Information APIs</a></strong><br />
|
|
The following <span class="keyword">iSeries Access for Windows</span> Directory
|
|
Update are used to obtain information from an update entry and to retrieve
|
|
general Directory Update information. The APIs are listed alphabetically.</li>
|
|
</ul>
|
|
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaikapiinterfaces.htm" title="iSeries Access for Windows provides C/C++ application programming interfaces (APIs) for accessing iSeries resources.">iSeries Access for Windows C/C++ APIs</a></div>
|
|
</div>
|
|
<div class="relref"><strong>Related reference</strong><br />
|
|
<div><a href="rzaikrcufapis.htm">Directory Update APIs return codes</a></div>
|
|
<div><a href="rzaikas400sysnameformat.htm" title="APIs that take an iSeries system name as a parameter accept names in the following formats.">iSeries system name formats for connection APIs</a></div>
|
|
<div><a href="rzaikcaexpressprogstd.htm" title="Most of the iSeries Access for Windows C/C++ APIs that accept string parameters exist in three forms: OEM, ANSI, or Unicode.">OEM, ANSI, and Unicode considerations</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |