PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • How to use HConnectionQuality?
  • Quality level of connection
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
HConnectionQuality (Function)
In French: HQualitéConnexion
HFSQL Client/ServerAvailable only with this kind of connection
Returns the quality level of connection: the higher the level is, the faster the connection will be.
Note: From version 19, HFSQL is the new name of HyperFileSQL.
Versions 23 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 23
iPhone/iPad This function is now available for the iPhone/iPad applications.
iPhone/iPad This function is now available for the 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 Name>)
<Result>: Integer
Quality level of connection. The higher the level is, the faster the connection will be.
<Connection Name>: Character string (with or without quotes)
Name of connection to check. This connection was defined in the data model editor, or by HDescribeConnection or HOpenConnection.
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, ...).
Components
WINDEVWEBDEV - Server codeReports and Queries wd230hf.dll
Windows Mobile wp230hf.dll
Linux wd230hf.so
See also
Minimum required version
  • Version 14
This page is also available for…
Comments
Click [Add] to post a comment