<Connection variable>.ConnectionQuality (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

HFSQL Client/Server functions

How to use <Connection variable>.ConnectionQuality?

Quality level of connection

See also

ActivateServerTrigger

AddGroup

AddLink

AddScheduledBackup

AddScheduledOptimization

DeactivateServerTrigger

DeleteScheduledBackup

DeleteScheduledOptimization

DescribeServerTrigger

ExecuteScheduledBackup

ListScheduledOptimization

ModifyDatabaseProperty

ModifyScheduledBackup

ModifyScheduledOptimization

NotifAddEmailRecipient

NotifConfigure

NotifDeleteCCRecipient

NotifDeleteEmailRecipient

NotifListCCRecipient

NotifListEmailRecipient

How to use <Connection variable>.ConnectionQuality?
Quality level of connection

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Connection variable>.ConnectionQuality (Function)

In french: <Variable Connexion>.QualitéConnexion

Available only with this kind of connection

Returns the quality level of connection: the higher the level is, the faster the connection will be. Remark: From version 19, HFSQL is the new name of HyperFileSQL.

Versions 23 and later

This function is now available for iPhone/iPad applications.

New in version 23

This function is now available for iPhone/iPad applications.

Example

// Checks the quality of connection
// Connection1 is a connection with compression
// Connection2 is a connection without compression
Connection1 is Connection
Connection2 is Connection

Result1 is int = Connection1.ConnectionQuality()
Result2 is int = Connection2.ConnectionQuality()
IF Result1 > Result2 THEN
Trace("The best connection is Connection1")
ELSE
Trace("The best connection is Connection2")
END

Syntax

<Result> = <Connection>.ConnectionQuality()

<Result>: Integer

Quality level of connection. The higher the level is, the faster the connection will be.

<Connection>: Connection variable

Name of the Connection variable that describes the connection to test.

Remarks

How to use <Connection variable>.ConnectionQuality?

<Connection variable>.ConnectionQuality must be used in the context of frame compression.

When should I compress the network frames?
The choice must be based on 3 parameters:

the speed of the network used,
the CPU performance of the client computers
the type of the transmitted data.

The importance of each parameter depends on the two other ones so no standard formula is available. However, you will find some tips that help you make this choice:

If the speed of the network used is greater than 10 Mbits/second, there is no need to compress the frames.
If the network used (GRPS, EDGE or 3G type) is invoiced according to the amount of transmitted data, we advise you to compress the frames in order to reduce the cost.
If an important amount of data (binary memo) is transmitted (images, video, zip sound, etc.), the compression of frames will be useless.
In all the other cases:
- on client computers equipped with high-performance processors and if text or text memo data is used by your application, it may be interesting to compress the frames.
- on client computers equipped with low-performance processors, it may be very interesting to compress the frames if the transfer rate is quite slow.
It may be interesting to perform comparative measurements by using the performance analyzer.

<Connection variable>.ConnectionQuality can be used to compare the performances between a compressed connection and an uncompressed connection.

Quality level of connection

The quality level of the connection depends on several parameters, for example:

The CPU workload of the client and server.
The use of the network resource by other programs.
The workload on the network devices (switch, router, ...).

Component: wd260hf.dll