iSeries Access for Windows Directory Update APIs

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.

How to install iSeries Access for Windows Directory Update:

To install Directory Update, follow these steps when you install iSeries Access for Windows, or when you run Selective Setup if iSeries Access for Windows is already installed:

Select the iSeries Access for Windows Optional Components check box.
Expand the view and make sure that the Directory Update subcomponent also is selected.
Follow the prompts to completion.

iSeries Access for Windows Directory Update C/C++ APIs:

iSeries Access for Windows Directory Update C/C++ application programming interfaces (APIs) allow software developers to add, change and delete update entries that are used by the iSeries Access for Windows Directory Update function.

Note: iSeries Access for Windows 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.

iSeries Access for Windows Directory Update APIs enable the:

Creation of update entries.
Deletion of update entries.
Modification of update entries.
Retrieval of information from update entries.
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 locked, use the information to find the name of the application that has the entries open.

IMPORTANT: The iSeries Access for Windows client does not include support for network drives or for universal naming conventions. This now is provided by the iSeries NetServer 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^® V4R2 and beyond in order to perform file serving to the iSeries server.

NetServer information resources:

iSeries NetServer topic of the iSeries Information Center
IBM^® iSeries NetServer Home Page

iSeries Access for Windows Directory Update APIs required files:

Header file	Import library	Dynamic Link Library
cwbup.h	cwbapi.lib	cwbup.dll

Programmer's Toolkit:

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 Directory Update > C/C++ APIs.

Note: By using the code examples, you agree to the terms of the Code license and disclaimer information.

Typical use of iSeries Access for Windows Directory Update APIs
iSeries Access for Windows 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.
Requirements for Directory Update entries
The following are required for Directory Update entries.
Options for Directory Update entries
The following are optional for Directory Update entries:
Directory Update package files syntax and format
Package files contain information that specifies and describes which target files users want to be kept current with source files.
Directory Update sample program
For a Directory Update C/C++ sample program, you can go to the Programmer's Toolkit - Directory Update Web page.
Directory Update: Create and delete APIs
The following iSeries Access for Windows Directory Update are used to create and delete an update entry. The APIs are listed alphabetically.
Directory Update: Access APIs
The following iSeries Access for Windows Directory Update are used to obtain access to an update entry. The APIs are listed alphabetically.
Directory Update: Free Resources APIs
The following iSeries Access for Windows Directory Update are used to free resources that are associated with an entry handle. The APIs are listed alphabetically.
Directory Update: Change APIs
The following iSeries Access for Windows Directory Update are used to change an update entry. The APIs are listed alphabetically.
Directory Update: Information APIs
The following iSeries Access for Windows Directory Update are used to obtain information from an update entry and to retrieve general Directory Update information. The APIs are listed alphabetically.

Parent topic: iSeries Access for Windows C/C++ APIs

Related reference

Directory Update APIs return codes

iSeries system name formats for connection APIs

OEM, ANSI, and Unicode considerations