<Variable Connection>.RSRenameServerName (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 / Managing replications / WLanguage functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Variable Connection>.RSRenameServerName (Function)

In french: <Connection variable>RSRenameServer

Changes the DNS name of the replication server if it has a new name.

Please note: this operation should only be carried out if only the server name has been modified (the server has remained unchanged: configuration, database architecture and system files must be the same). In particular, the replication configuration in the HFConf.ini file must not have been changed. Example:

[REPLICATION]
PRIORITY=2
PASSWORD=XXXXX
PORT=9792
ROLE=3
SERVER_ID=2

Example

listeRS is array of hRSConfig

// Liste des réplications
listeRS = MaConnexion1.RSListeConfig()
FOR EACH ConfigRéplication OF listeRS
	// Si la configuration doit être modifiée
	ConfigRéplication.Serveur = "MonNouveauNomDeServeur:4997"
	IF NOT MaConnexion1.RSRenommeNomServeur(ConfigRéplication) THEN
		Trace(HErrorInfo())
	END
END

Syntax

<Result> = <Connection>.RenameServer(<Replication to rename>)

<Result>: Boolean

True if the replication was modified,
False otherwise. HErrorInfo is used to identify the error.

<Connection>: Connection variable

Connection to the master HFSQL server on which the replication configuration is to be modified. This connection corresponds to:
the name of the connection defined in the data model editor or with HDescribeConnection or <Connection variable>.OpenConnection.
the name of a variable of type Connection.

<Replication to rename>: hRSConfig variable

Name of the hRSConfig variable describing the modified replication to update.

Remarks

This operation must be done only if the server is identical, except for its DNS name. The configuration, database architecture and system files must be the same.
<Variable Connection>.RSRenameServerName does not allow you to "duplicate" or "move" a replication to another server.
In a bidirectional replication, <Variable Connection>.RSRenameServerName must be called on the connection that corresponds to the server whose name has not been changed.
In a unidirectional replication, <Variable Connection>.RSRenameServerName must be called on the connection that corresponds to the master server.
In a unidirectional replication, if the name of the master server has changed, no additional actions are required. The modification will be automatically applied.

Business / UI classification: Business Logic

Component: wd300hf.dll