ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaik_5.4.0.1/rzaikupdatex.htm

172 lines
12 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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> &gt; <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>