Sends a "ping" request to a computer. Ping is used to test server response times on a TCP/IP network. If the computer does not respond within the time specified, the step generates an error. Used to check response times of servers connected to the Internet or private TCP/IP network.
Declaration
<AMPING HOST="text/number" TIMEOUT="number" MEASURE="text (options)" RESULTVARIABLE="text" IPADDRESSVARIABLE="text" />
Example
<AMPING HOST="123.456.789.123" TIMEOUT="2" MEASURE="minutes" RESULTVARIABLE="theRelayTime" IPADDRESSVARIABLE="theIP" />
See Also: Send Email, Connect to Network Action, HTTP, Map Drive
To set Ping Machine properties
In the Available Actions pane, open the Network folder and double-click the Ping Machine action or drag it into the Steps pane.
Enter the host name or IP address of the machine to be pinged.
In the Time to wait box, enter the time in seconds that you want AWE to wait for a response before generating a step error. The default is 10 seconds.
In the Populate variable with relay time and Populate variable with IP address boxes, use the drop-down lists to select the variables.
To set the Description tab properties, refer to Description Tab Options.
To set the Error Causes and On Error tab properties, refer to Step Error Handling.
When finished, click OK to save settings and close the properties dialog box.
Property |
Type |
Required |
Default |
Markup |
Description |
Hostname or IP |
Text or Number |
Yes |
(Empty) |
a)HOST="server.domain.com" b)HOST="xxx.xxx.xxx.xxx" |
The hostname or IP Address that should be "pinged". This value can be a hostname such as server.domain.com or an IP address such as 555.555.555.555. |
Time to Wait |
Number |
No |
10 |
TIMEOUT="2" |
The length of time this step should wait for a response from the server being "pinged" before generating an error. This value is used along with the Measure parameter. |
Measure |
Text (options) |
No |
seconds |
MEASURE="minutes" |
The time measure to use along with the Time to Wait parameter. The available options are:
|
Populate variable with relay time (in milliseconds) |
Text |
No |
(Empty) |
RESULTVARIABLE="theRelayTime" |
The name of an existing variable to populate with the total relay time (in milliseconds). |
Populate variable with IP address |
Text |
No |
(Empty) |
IPADDRESSVARIABLE="theIP" |
The name of an existing variable to populate with the "pinged" IP address. |