HRSRenameServer (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

Managing databases

Managing replications

WLanguage functions

Prefix syntax

HRSRenameServer

Presentation

Example

See also

HRSRenameServer (Function)

In french: HRSRenommeNomServeur

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

Caution: This operation must be done if only the server name has been changed (other aspects of the server are left 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

listRS is array of hRSConfig

// List of replications
listRS = HRSListConfig(MyConnection1)
FOR EACH ConfigReplication OF listRS
// If the configuration must be changed
ConfigReplication.Server = "MyNewServerName:4997"
IF NOT HRSRenameServer(MyConnection1, ConfigReplication) THEN
Trace(HErrorInfo())
END
END

Syntax

<Result> = HRSRenameServer(<Connection> , <Replication to rename>)

<Result>: Boolean

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

<Connection>: Character string or Connection variable

Connection to the master HFSQL server on which the replication configuration must be changed. This connection corresponds to:
the name of the connection defined in the data model editor or with HDescribeConnection or HOpenConnection.
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.
HRSRenameServer does not allow you to "duplicate" or "move" a replication to another server.
In a bidirectional replication, HRSRenameServer must be called on the connection that corresponds to the server whose name has not been changed.
In a unidirectional replication, HRSRenameServer 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: wd280hf.dll