Home | Sign in | English UK

  • Range of identifiers
  • Replication and log process
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Stored procedures
HInitSubscriber (Function)
In french: HInitAbonné
HFSQLHFSQL Client/ServerAvailable only with these kinds of connection
Initializes the range of automatic identifiers for the description file of subscriber replica (".RPL" extension). This function is available for the logged replication only.
The range of automatic identifiers is initialized:
HInitSubscriber must be called only when the data files are installed on the subscriber.
Caution: The data files must be opened before using HInitSubscriber.
Note: From version 19, HFSQL is the new name of HyperFileSQL.
// Initializes the range of auto IDs for CUSTOMER file
HInitSubscriber("CUSTOMER", "C:\DATA\Replic\ParisSubscriber.RPL")
// Initializes the range of auto IDs for all the files
HInitSubscriber("*", "C:\DATA\Replic\ParisSubscriber.RPL")
<Result> = HInitSubscriber(<File name> , <Subscriber Replica>)
<Result>: Boolean
  • True if the initialization was performed,
  • False if an error occurred. HErrorInfo is used to identify the error.
<File name>: Character string (with or without quotes)
Name of logical HFSQL data file to use.
If this parameter is equal to "*", the ranges of identifiers will be initialized for all the data files described as "replicated" in the analysis.
<Subscriber Replica>: Character string
Name and full path of subscriber replica. This parameter can correspond to a UNC path.

Range of identifiers

The automatic identifiers for the files of subscriber replicas are using a range of identifiers that differs from the one used by the file of master replica and by the other files of subscriber replicas.
This range of automatic identifiers is written in the header of each data file (".FIC" extension).
This range is initialized:
  • when creating a data file (HCreation, HCreationIfNotFound).
  • via WDReplic ("Tools .. WDReplic" in the main menu of editors).via WDReplic. To start this tool, on the "Tools" pane, in the "Database" group, expand "Replication" and select "WDReplic - Replication manager".via WDReplic.
  • when using HInitSubscriber.
The range of identifiers is returned by ..MinAutoID and ..MaxAutoID.

Replication and log process

If HInitSubscriber is used, the location of logs and operation tables must also be initialized (HChangeLogDir, ..LogDirectory and ..OperationLogDirectory).
Reminder: The logged replication is based on the logs and on the operation tables of the data files. The logged replication cannot operate if the location of the logs and operation tables is invalid.
Component : wd240rpl.dll
Minimum version required
  • Version 9
This page is also available for…
Click [Add] to post a comment