HSimulateNetwork (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 / HFSQL Client/Server functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HSimulateNetwork (Function)

In french: HSimuleRéseau

Available only with this kind of connection

Simulates how the HFSQL Client/Server works:

on an ADSL, 3G, 4G and 5G network or via the cloud.
on a slow network with custom settings.

Remark: This function enables you to test an application using HFSQL, either locally or over a LAN, under the conditions of an ADSL, 3G, 4G, 5G or cloud network, or with customized parameters.. This function slows down all the communications between the client and the HFSQL server.

This function is used when debugging and optimizing an application.

Example

// Simulation du réseau 3G
HSimulateNetwork(h3G)
ProfilerStart()
Proc_Traitement() // Traitement dont on veut analyser la performance en 3G
ProfilerEnd()
// Retour à un fonctionnement normal
HSimulateNetwork(hNone)

Syntax

Simulating how HFSQL Client/Server works in a previously configured network Hide the details

<Result> = HSimulateNetwork([<Connection>, ] <Type of network>)

<Result>: Boolean

True if the simulation is launched,
False if an error occurs.

<Connection>: Character string or Connection variable

Connection to use. 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.
If this parameter is not specified, the simulation is applied to all the current and future connections.

<Type of network>: Integer constant

Type of network to simulate:
h3G Type of network to be simulated: 3G
Characteristics (estimate): Latency: 130ms, Data rate: 1 Mbps
h4G Network type to be simulated: 4G
Specifications (estimate): Latency: 40ms, Throughput: 30 Mbps
h5G Network type to be simulated: 5G
Characteristics (estimate): Latency: 10ms, Throughput: 100 Mbps
hADSL Network type to be simulated: ADSL
Specifications (estimate): Latency: 40ms, Data rate: 8 Mbps
hCloud Type of network to be simulated: Cloud.
Characteristics (estimate): Latency: 10ms, Throughput: 400 Mbps
These values apply when the application is used from the same continent as the data center, with a fiber Internet connection. If the application is used from another continent, or with a Wi-Fi connection, it is recommended to use the second syntax of the function by specifying the latency and the speed of the connection.
hNone Used to disable the simulation of a specific network.

Simulating how HFSQL Client/Server works in a custom network Hide the details

<Result> = HSimulateNetwork([<Connection>, ] <Latency> , <Bandwidth>)

<Result>: Boolean

True if the simulation is launched,
False if an error occurs.

<Connection>: Character string or Connection variable

Connection to use. 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.
If this parameter is not specified, the simulation is applied to all the current and future connections.

<Latency>: Integer

Simulated latency expressed in milliseconds. This latency is added to the latency of the current network.

<Bandwidth>: Real

Bandwidth expressed in megabits per second. It represent the time needed to transfer a given amount of data (assuming that the current network has an infinite bandwidth).

Remarks

This function must not be used in a deployed application. This function is used when debugging and optimizing an application.
This function increases the latency and reduces the throughput of the network connections used for HFSQL Client/Server.

Business / UI classification: Business Logic

Component: wd300hf.dll