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

84 lines
4.7 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="cwbUP_SetEntryAttributes" />
<meta name="DC.Relation" scheme="URI" content="rzaikufapilist4.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="cwbup_setentryattributes" />
<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>cwbUP_SetEntryAttributes</title>
</head>
<body id="cwbup_setentryattributes"><a name="cwbup_setentryattributes"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1"><span class="apiname">cwbUP_SetEntryAttributes</span></h1>
<div><div class="section"><h4 class="sectiontitle">Purpose</h4><div class="p">Sets any of the following attribute values
of the update entry: <dl><dt class="dlterm">CWBUP_FILE_DRIVEN</dt>
<dd>Updates are based on file date comparisons between target and source files.</dd>
<dt class="dlterm">CWBUP_PACKAGE_DRIVEN</dt>
<dd>Updates are based on contents of the package file(s), and comparisons
of their files' dates between target and source.</dd>
<dt class="dlterm">CWBUP_SUBDIRECTORY</dt>
<dd>Update compares and updates directories under the given path.</dd>
<dt class="dlterm">CWBUP_ONEPASS</dt>
<dd>Updates occur directly in one pass. If this isn't specified, updates occur
in two passes. The first pass copies the files to be updated to a temporary
directory, and then when the PC is rebooted, the files are copied to the target
directory.</dd>
<dt class="dlterm">CWBUP_BACKLEVEL_OK </dt>
<dd>If this is set, updates will occur if the dates of the files on the source
and target don't match. If this is not set, updates will only occur if the
source file is more recent than the target file.</dd>
</dl>
Any combination of these values is valid.</div>
</div>
<div class="section"><h4 class="sectiontitle">Syntax</h4><pre>
unsigned int CWB_ENTRY cwbUP_SetEntryAttributes(
cwbUP_EntryHandle entryHandle,
unsigned long entryAttributes);</pre>
</div>
<div class="section"><h4 class="sectiontitle">Parameters</h4><dl><dt class="dlterm">cwbUP_EntryHandle entryHandle - input</dt>
<dd>Handle that was returned by a previous call to <span class="apiname">cwbUP_CreateUpdateEntryHandle</span>, <span class="apiname">cwbUP_GetUpdateEntryHandle</span>, or to <span class="apiname">cwbUP_FindEntry</span>.</dd>
<dt class="dlterm">unsigned long entryAttributes - input</dt>
<dd>Combination of the attribute values. (See defines section for values)</dd>
</dl>
</div>
<div class="section"><h4 class="sectiontitle">Return Codes</h4><p>The following list shows common return
values.</p>
<dl><dt class="dlterm">CWB_OK</dt>
<dd>Successful completion.</dd>
<dt class="dlterm">CWB_INVALID_HANDLE</dt>
<dd>Update entry handle is not valid.</dd>
<dt class="dlterm">CWBUP_ENTRY_IS_LOCKED</dt>
<dd>Another application is currently changing the update entry list. No changes
are allowed at this time.</dd>
</dl>
</div>
<div class="section"><h4 class="sectiontitle">Usage</h4><p>An example of this call follows:</p>
<samp class="codeph">rc
= cwbUP_SetEntryAttributes(entryHandle, CWBUP_FILEDRIVEN | CWBUP_ONEPASS
);</samp><p>This call would result in the update entry being file driven
and the update would occur in one pass.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaikufapilist4.htm" title="The following iSeries Access for Windows Directory Update are used to change an update entry. The APIs are listed alphabetically.">Directory Update: Change APIs</a></div>
</div>
</div>
</body>
</html>