DbEnv::rep_sync

API Ref

#include <db_cxx.h>

int DbEnv::rep_sync(u_int32_t flags);


Description: DbEnv::rep_sync

The DbEnv::rep_sync method forces master synchronization to begin for this client. This method is the other half of setting the DB_REP_CONF_DELAYCLIENT flag via the DbEnv::rep_set_config method.

If an application has configured delayed master synchronization, the application must synchronize explicitly (otherwise the client will remain out-of-date and will ignore all database changes forwarded from the replication group master). The DbEnv::rep_sync method may be called any time after the client application learns that the new master has been established, either by receiving a DB_EVENT_REP_NEWMASTER event notification, or from a DB_REP_NEWMASTER return code from DbEnv::rep_process_message.

The DbEnv::rep_sync method may not be called before the DbEnv::open method has been called.

The DbEnv::rep_sync method either returns a non-zero error value or throws an exception that encapsulates a non-zero error value on failure, and returns 0 on success.

Parameters

flags
The flags parameter is currently unused, and must be set to 0.

Class

DbEnv

See Also

Replication and Related Methods

APIRef

Copyright (c) 1996-2006 Oracle Corporation - All rights reserved.