HChangeRplDir (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / Managing databases / HFSQL / HFSQL functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HChangeRplDir (Function)

In french: HChangeRepRpl

Available only with these kinds of connection

Changes the location of the subscriber replica description ("*.rpl" file). This function must be used on the subscriber computer.

This is an advanced function of log-based replication. It should be used when handling databases not connected by network for example. In this case, the master replica and the subscriber replica are created on the same computer (master computer). The "rpl" file (subscriber replica file) is then copied to the subscriber computer.

This file can be installed:

in the replication directory specified in the analysis ("\_RPL" subdirectory of data files by default).
in another directory. In this case, the subscriber application must use HChangeRplDir to specify the location where the file of subscriber replica must be sought. When the subscriber data file is opened, the RPL file is read to define the range of automation identifiers used by the data file.

By default, the replication files are managed in the directory specified in the analysis ("Analysis description", "Log process" tab).

Example

// Le fichier "rpl" se trouve dans le même répertoire que les fichiers de données
HChangeRplDir(".")

// Le fichier "rpl" se trouve dans le sous-répertoire des fichiers de données \RPL
HChangeRplDir(".\RPL") 

// Le fichier "rpl" se trouve dans le répertoire "X:\Data\RPL"
HChangeRplDir("X:\Data\RPL")

Syntax

<Result> = HChangeRplDir(<Location of subscriber replica file>)

<Result>: Boolean

True if the operation was performed,
False if a problem occurs. HErrorInfo is used to identify the error.

<Location of subscriber replica file>: Character string

New path to the "*.rpl" file corresponding to the subscriber replica (full or relative path). This directory is used:
when opening an HFSQL data file in replication on the subscriber computer. The range of automatic identifiers is updated.
when performing the synchronization (HSynchronizeReplica for example) if no directory is specified.
Note If the directory is relative, it will be relative to the default data file directory defined in the analysis.

Business / UI classification: Business Logic

Component: wd300rpl.dll