HConnectionQuality (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | French

HFSQL Client/Server functions

HConnectionQuality

Presentation

Example

How to use HConnectionQuality?

Quality level of connection

HAddScheduledOptimization

HCS.Timeout (Variable)

HDeleteScheduledBackup

HDeleteScheduledOptimization

HExecuteScheduledBackup

HExecuteScheduling

HInfoBackup

HInfoDatabaseProperty

HListScheduledOptimization

HModifyDatabaseProperty

HModifyDatabaseRights

HModifyFileProperty

HModifyFileRights

HModifyGroup

HModifyScheduledBackup

HModifyScheduledOptimization

HModifyScheduling

HModifyServerProperty

HNotifAddEmailRecipient

HNotifConfigure

HNotifDeleteCCRecipient

HNotifDeleteEmailRecipient

HNotifListCCRecipient

HNotifListEmailRecipient

How to use HConnectionQuality?
Quality level of connection

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HConnectionQuality (Function)

In french: HQualité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
Result1 is int = HConnectionQuality(Connection1)
Result2 is int = HConnectionQuality(Connection2)
IF Result1 > Result2 THEN
Trace("The best connection is Connection1")
ELSE
Trace("The best connection is Connection2")
END

Syntax

<Result> = HConnectionQuality(<Connection>)

<Result>: Integer

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

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

Connection to test. 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.

Remarks

How to use HConnectionQuality?

HConnectionQuality 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.

HConnectionQuality 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