HRSAddConfig (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HRSAddConfig (Function)

In french: HRSAjouteConfig

Available only with this kind of connection

Adds a replication between two HFSQL server onto the master server. Remark: From version 19, HFSQL is the new name of HyperFileSQL.

Example

ConfigReplication1 is hRSConfig
ConfigReplication1..Server = "atlas.mycompany.com:4996"
Add(ConfigReplication1..File, "MyDatabase")
Add(ConfigReplication1..File, "-MyDatabase\MyFile.fic")
HRSAddConfig(Cnt, ConfigReplication1, False)

Cnt is Connection
ConfigReplication1 is hRSConfig

ConfigReplication1..Server = "atlas.mycompany.com:4996"
Add(ConfigReplication1..File, "MyDatabase")
Add(ConfigReplication1..File, "-MyDatabase\MyFile.fic")
HRSAddConfig(Cnt, ConfigReplication1, hrsNoCopy)

Syntax

<Result> = HRSAddConfig(<Connection> , <Replication to perform> , <Initial copy> [, <Progress Bar>])

<Result>: Boolean

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

<Connection>: Character string (with or without quotes)

Connection to the master HFSQL server. This connection was defined in the data model editor, or by programming with HDescribeConnection or HOpenConnection.

<Replication to perform>: hRSConfig variable

Name of hRSConfig variable describing the replication to perform.

<Initial copy>: Boolean

True to enable the initial copy of replicated elements from the connection server (master server) to the other server (subscriber server, defined in the hRSConfig variable).
False otherwise.

<Progress Bar>: Optional character string (with or without quotes)

Name of the Progress Bar control used to see the progress of initial copy.

<Result> = HRSAddConfig(<Connection> , <Replication to perform> , <Option> [, <Progress Bar>])

<Result>: Boolean

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

<Connection>: Character string (with or without quotes) or Connection variable

Connection to the master HFSQL server. This connection corresponds to:
the name of the connection defined in the data model editor or with HDescribeConnection or HOpenConnection.
the name of a Connection variable.

<Replication to perform>: hRSConfig variable

Name of hRSConfig variable describing the replication to perform.

<Option>: Integer constant

Action to perform:
Versions 22 and later
hrsCopy
New in version 22
hrsCopy
hrsCopy Enables the initial copy of replicated elements from the connection server (master server) to the other server (subscriber server, defined in the hRSConfig variable). This copy is locking.
Compatibility with the earlier versions: Corresponds to True in the earlier versions.
Versions 22 and later
hrsCopyBackgroundTask
New in version 22
hrsCopyBackgroundTask
hrsCopyBackgroundTask Enables the initial copy of replicated elements from the connection server (master server) to the other server (subscriber server, defined in the hRSConfig variable). This copy is performed in background task and it is not locking.
To find out whether the copy was performed:
List the available replications with HRSListConfig.
The requested replication was not added if it is not listed.
If the requested replication is found, check the value of ..Initialization of hRSConfig variable. If this property:
is included between 0 and 1000, the replication is currently added.
is set to 1000, the replication was added.
is not specified, the replication failed to be added.
Versions 22 and later
hrsNoCopy
New in version 22
hrsNoCopy
hrsNoCopy No copy is performed.
Compatibility with the earlier versions: Corresponds to False in the earlier versions.

<Progress Bar>: Optional control name

Name of the Progress Bar control used to see the progress of initial copy.

Component : wd260hf.dll