This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / Managing databases / HFSQL / Types of HFSQL variables
  • Properties specific to hRSConfig variables
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
The hRSConfig type is used to define the advanced characteristics of a replication between 2 HFSQL servers. The characteristics of this replication can be defined and modified by several WLanguage properties.
Remark: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.
Cnt is Connection
ConfigReplication1 is hRSConfig

ConfigReplication1.Server = ""
Add(ConfigReplication1.File, "MyDatabase")
Add(ConfigReplication1.File, "-MyDatabase\MyFilefic")
HRSAddConfig(Cnt, ConfigReplication1, hrsNoCopy)

Properties specific to hRSConfig variables

The following properties can be used to handle a replication between HFSQL servers:
Property nameType usedEffect
  • True if the replication must be performed in both directions: the replication will be bidirectional.
  • False otherwise (default value): the replication will be unidirectional.
DescriptionCharacter stringDescription of replication.
FileArray of stringsList of elements to replicate.
The elements to replicate can correspond to:
  • a database,
  • a data file,
  • a data file to exclude from the replication. In this case, the name of the file must be prefixed by "-" (minus).
IdentifierIntegerUsed to identify the replication handled.
This property is read-only.
IdentifierOpposedIntegerIn the case of bidirectional replication, Receiver is the replication identifier from the opposite server to the replicated server..
This property is read-only.
InitializationentierUsed to follow the evolution of the initial copy of replicated elements from the connection server (master server) to the other server (subscriber server) during a copy in background task (HRSAddConfig associated with the hrsCopyBackgroundTask constant).
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.
This property is read-only.
ModificationConflictResolutionInteger constantMethod for solving conflicts:
  • hmcrHigherPriority (default value): During a conflict, only the priority value defined for the server is taken into account. The smaller the priority value defined for the server is, the higher the priority granted to the server will be.
  • hmcrMoreRecent: During a conflict, the more recent element has priority.
    Caution: This method requires a synchronization of the clock on the different servers.
  • hmcrProcedureWithModifiedItems: When a conflict occurs, a stored procedure (defined with the ProcedureForModificationConflictResolution property) is started. In this procedure, only the modified items will be accessible.
  • hmcrProcedureAllItems: When a conflict occurs, a stored procedure (defined with the ProcedureForModificationConflictResolution property) is started. In this procedure, all the items found in the record will be accessible.
PasswordCharacter stringPassword specific to the replication. This password must correspond to the password specified in HRSInit used on the subscriber server.
This property is available in write mode.
ProcedureForModificationConflictResolutionCharacter stringName of the stored procedure to be used if the conflict resolution method (ModificationConflictResolution) corresponds to the hmcrProcedureWithModifiedItems or hmcrProcedureAllItems constants.
This stored procedure must return:
  • the opRetry constant to validate the replication of the modification,
  • the opCancel constant to cancel the replication of the modification.
This stored procedure must be found in the replicated database on the subscriber server.
SchedulinghScheduling variableReplication period.
If all the members of the hScheduling variable are left empty, it will be a replication in streaming.
ServerCharacter stringTarget server of the replication. This server is identified by:
  • its DNS name or its IP address.
  • the replication port (4996 by default).
If the port differs from the default port, the following syntax must be used to specify it: "<Server name>:<Replication port>". This port must correspond to the port specified in HRSInit used on the subscriber server.
  • True to perform a replication in spare mode,
  • False otherwise.
Remark: This property is not compatible with the Bidirectional property.
Minimum version required
  • Version 18
This page is also available for…
Click [Add] to post a comment

Last update: 02/02/2024

Send a report | Local help