<Connection variable>.RSInit (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / Managing databases / HFSQL / Managing replications / WLanguage functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Connection variable>.RSInit (Function)

In french: <Variable Connexion>.RSInit

Configures an HFSQL server in order for this server to be a master server or a subscriber server for a replication between HFSQL servers.

Example

// Describe the connection
MyConnection is Connection

MyConnection.RSInit(hrsSubscriber, 1, "pwd", 4996, 5)

Syntax

<Result> = <Connection>.RSInit(<Server role> , <Server identifier> , <Password> , <Port> , <Priority>)

<Result>: Boolean

True if the configuration has been carried out,
False otherwise. HErrorInfo is used to identify the error.

<Connection>: Connection variable

Name of the Connection variable that describes the connection to the HFSQL server to configure.

<Server role>: Integer constant

Role of the server in the replication:
hrsInactive Inactive computer in the replication between HFSQL servers.
hrsMaster Master computer in the replication between HFSQL servers.
hrsMaster + hrsSubscriber Master and subscriber computers in the replication between HFSQL servers (for a bi-directional replication).
hrsSubscriber Subscriber computer in the replication between HFSQL servers.

<Server identifier>: Integer

Number used to identify the current HFSQL server among all the servers involved in a replication. This identifier must be unique. This identifier must be between 1 and 32000.

<Password>: Character string

Replication password, used to authenticate the servers between themselves. This password must be used on the other server in the call to <Connection variable>.RSAddConfig (i.e. in the Password property of the hrsConfig variable).
To use the bidirectional replication, the password must be the same on the two servers.
New in version 2025
Secret strings: If you use the secret string vault, the type of secret string used for this parameter must be "ANSI or Unicode string".
To learn more about secret strings and how to use the vault, see Secret string vault.

<Port>: Integer

TCP/IP port number used for the replication between HFSQL servers.

<Priority>: Integer

Priority number of server. During a modification conflict, this number is used if the method for solving the conflict corresponds to a resolution by priority.

Remarks

<Connection variable>.RSInit can be used several times on the same server, to change the role of a server in a replication, for example.

Component: wd300hf.dll