DSPing Pro COMPONENT v1.0
Home

 

Why DSPing Pro..

DSPing Pro exposes more features than our free DSPing component:

About DSPing Pro

Use DSPing Pro to ping hosts and network resources. DSPing Pro can even ping server behind firewalls that block ICMP (i.e.: www.microsoft.com). DSPing Pro is light weight and can be used from any com compliant programming language: Scripting languages (VBScript, JavaScript), Visual Basic (Versions 4 and up), VBA (Word, Excel, Access ...), VC++, BC++, Delphi, Power Builder to name only a few.

DSPing Pro Installation

Setting up the component is very simple using the provided installation utility. The only file required for the component to function properly is DSPingPro.DLL. It is copied to the system directory (i.e.: \WINNT\System32 for NT or \Windows\System for Win95). However if you with to move the files to another directory remember to register the component using the resgsrv32 program.

Change to the directory where you copied the DLL and type:

regsvr32 dspingpro.dll

If you get an error message at the end of the installation procedure "cannot register...", some of your system files might need to be updated to the latest version.

DSPing Pro usage Example

Pinging a host from ASP:

Dim Ping, Result
Set Ping = CreateObject( "DSPINGPRO.IcmpPing" )
Result = Ping.Ping("www.donia.com", 1000, 32, 500, 3)

If Result = 0 then
	Response.Write "Ping successful."
	Response.Write "<BR>Approximate round trip times in milliseconds:"
        Response.Write "<BR>Minimum = " & Ping.Minimum & "ms"
        Response.Write "<BR>Maximum = " & Ping.Maximum & "ms"
        Response.Write "<BR>Average = " & Ping.Average & "ms"
        Response.Write "<BR>Packets sent = " & Ping.PacketsSent
	Response.Write "<BR>Packets received = " & Ping.PacketsReceived
Else
	Response.Write "Ping Failed."
End IF

Pinging a host with blocked ICMP from ASP:

Dim Ping, Result
Set Ping = CreateObject( "DSPINGPRO.ServerPing")
Result = Ping.Ping("www.donia.com", 80, 3, 1000)

If Result = 0 then
	Response.Write "Ping successful."
	Response.Write "<BR>Approximate round trip times in milliseconds:"
        Response.Write "<BR>Minimum = " & Ping.Minimum & "ms"
        Response.Write "<BR>Maximum = " & Ping.Maximum & "ms"
        Response.Write "<BR>Average = " & Ping.Average & "ms"
Else
	Response.Write "Ping Failed."
End IF

See the Result codes below for specific failure causes.

Samples

Visual Basic: This sample demonstrates how to use all of the methods exposed by the component.

 

About Upgrades

  1. Users can upgrade for free for minor version changes. For example, upgrades from version 1.00 to 1.99 are free. The upgrade from 1.99 to 2.0 may carry an additional license fee.
  2. The latest version of the components are always available at http://www.donia.com/products.htm. If a fee is associated with obtaining the upgrade it will be noted on that page.

Upgrade Instructions

To upgrade the component from a previous version please follow these steps:

  1. Stop all programs using the component. If you are using it in ASP stop IIS related services such as Gopher, FTP and W3SVC..
  2. Install the update using the provided setup utility.
  3. Don't forget to run regsvr32 as described above if you choose to move the DLL to another directory.
  4. Restart the necessary programs / services.

Technical Support

If you require technical support please send complete details about the problem you are having to support@donia.com. Include the version of DSPing Pro you are using, any error messages, sample code snippets that demonstrate the problem (most problems are scripting errors), information about the hosting environment etc. For example, if you are using ASP to host the component please let me know what version of IIS and ASP you are running (and if you have installed any of the Hot Fixes). The more information you can provide in your request for help, the faster your problems can be resolved.

IcmpPing Properties

Property Description
Average Average approximate round trip time in milliseconds after a successful ping, or zero after a failed ping.

This property is read only.

Maximum Maximum approximate round trip time in milliseconds after a successful ping, or zero after a failed ping.

This property is read only.

Minimum Minimum approximate round trip time in milliseconds after a successful ping, or zero after a failed ping.

This property is read only.

PacketsSent Number of ICMP packets sent.
PacketsReceived Number of ICMP packets received.

 

IcmpPing Methods

Method Parameters Return Value Description
Ping Address, [Timeout], [Datasize], [Interval], [Count]

Address : host name or IP address of the destination network resource to ping.

[Timeout]
: optional timeout in milliseconds to wait for each reply. Default = 1000.

[DataSize]
: optional  Send buffer size Default = 32 bytes.

[Interval]
: optional  Interval in milliseconds between sends. Default = 500.

[Count]
: optional  number of echo requests to send. Default = 3.

Zero  or error code based upon success or failure.

Ping a host by IP address or host name 

Return values :

PING_OK  0
SOCKETERROR 1
CONNECTFAILED 2
INVALIDADDRESS 3
CONNECTTIMEOUT 4
About

 

None   Displays version and copyright information.

 

ServerPing Properties

Property Description
Average Average approximate round trip time in milliseconds after a successful ping, or zero after a failed ping.

This property is read only.

Maximum Maximum approximate round trip time in milliseconds after a successful ping, or zero after a failed ping.

This property is read only.

Minimum Minimum approximate round trip time in milliseconds after a successful ping, or zero after a failed ping.

This property is read only.

 

ServerPing Methods

Method Parameters Return Value Description
Ping Address, Port, [Count], [Timeout]

Address : host name or IP address of the destination network resource to ping.

Port : Port number to ping:
80 http, 21 ftp...

[Count]
: optional  number of echo requests to send. Default = 3.

[Timeout]
: optional timeout in milliseconds to wait for each reply. Default = 1000.

Zero  or error code based upon success or failure.

Ping a host by IP address or host name 

Use this method when pinging ip addresses that have ICMP blocked (i.e. www.microsoft.com)

Return values :

PING_OK  0
SOCKETERROR 1
CONNECTFAILED 2
INVALIDADDRESS 3
CONNECTTIMEOUT 4
About

 

None   Displays version and copyright information.

 


Donia Software
Copyright 1998 - 1999 Hassan Fekih. All Rights Reserved.