HInitSubscriber (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | Français

Replication and log process

HCreateMoveableReplica

HCreateSubscriberReplica

HDeactivateAutoFilter

HDescribeFullTextIndex

HErrorStatusModification

HFilterIncludedBetween

HMigrateLinkedCompositeKey

HRecreateSubscriberReplica

This content comes from an automatic translation.

Range of identifiers
Replication and log process

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HInitSubscriber (Function)

In french: HInitAbonné

Available 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:

automatically, when creating a data file (HCreation, HCreationIfNotFound).
manually, by HInitSubscriber.

HInitSubscriber must be called only when the data files are installed on the subscriber.

Caution: The data files must be opened before HInitSubscriber is used. Remark: From version 19, HFSQL is the new name of HyperFileSQL.

Example

// Initializes the Auto ID range of the CLIENT data file
HInitSubscriber("CUSTOMER", "C:\DATA\Replic\ParisSubscriber.RPL")

// Initializes the Auto ID range of all data files
HInitSubscriber("*", "C:\DATA\Replic\ParisSubscriber.RPL")

Syntax

<Result> = HInitSubscriber(<Data file> , <Subscriber Replica>)

<Result>: Boolean

True if the initialization was performed,
False if an error occurred. HErrorInfo is used to identify the error.

<Data file>: Character string (with or without quotes)

Name of data file HFSQL to be used.
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.

Remarks

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).
with the WDReplic tool ( "Tools... WDReplic" option in the main editors' menu).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 the HInitSubscriber function.

The range of identifiers is returned by ..MinAutoID and ..MaxAutoID.

See the consequences of implementing the replication for more details.

Replication and log process

If the HInitSubscriber function is used, it is also necessary to initialize the location of logs and transaction tables (HChangeLogDir function, ..LogDirectory and ..OperationLogDirectory properties).

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 : wd250rpl.dll