NWDSRepairTimeStamps(3nw)


NWDSRepairTimeStamps -- sets the time stamps for all of a partition's objects and object attributes to the current time on the NetWare server where the master replica is located

Synopsis

   #include <nwnet.h> 
   or 
   #include <nwdsmisc.h> 
   

NWDSCCODE N_API NWDSRepairTimeStamps (NWDSContextHandle context, pnstr8 partitionRoot);

Description

The parameters are as follows:

context
(IN) Specifies the Directory context for the request.

partitionRoot
(IN) Points to name of the partition's root object.

Return values

0x0000
SUCCESSFUL

Negative Value
Negative values indicate errors. For errors returned by Directory Services, see ``Directory Services OS Errors'' (-001 to -255), ``Directory Services Client Library Errors'' (-301 to -399), or ``Directory Services Agent in the Server Errors'' (-601 to -699).

0x8996
SERVER_OUT_OF_MEMORY

0x89E2
TOO_FEW_FRAGMENTS

0x89E3
TOO_MANY_FRAGMENTS

0x89E4
PROTOCOL_VIOLATION

0x89E5
SIZE_LIMIT_EXCEEDED

0x89FD
UNKNOWN_REQUEST

0x89FD
INVALID_PACKET_LENGTH

0x89FE
BAD_PACKET

0x89FF
Failure not related to Directory Services

Notices

NWDSRepairTimeStamps sets the time stamps on all of the objects and their attributes, even if valid time stamps exist. It will replace information such as the creation dates of the attributes.

After NWDSRepairTimeStamps is called, the Directory will synchronize all replicas to match the information in the master replica.


CAUTION: Because of the wide scope of changes made by NWDSRepairTimeStamps, it should be used only to recover from a catastrophic failure.

One concern with using NWDSRepairTimeStamps is that it can result in the loss of information. For example, any changes that have been made on replicas other than the master replica will be lost if they have not been synchronized with the master replica before NWDSRepairTimeStamps is called.

Another concern is with applications that use NDS Event Notification Services. After NWDSRepairTimeStamps is called, NDS will produce event notifications for every object and attribute on the master replica. It will also provide the same notification each time one of the other replicas is synchronized with the master replica.


Services

Directory

NCP calls

0x2222 23 17
Get File Server Information

0x2222 23 22
Get Station's Logged Info (old)

0x2222 23 28
Get Station's Logged Info

0x2222 104 01
Ping for NDS NCP

0x2222 104 02
Send NDS Fragmented Request/Reply

30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.