Ping Machine

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

  1. In the Available Actions pane, open the Network folder and double-click the Ping Machine action or drag it into the Steps pane.

  2. Enter the host name or IP address of the machine to be pinged.

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

  4. In the Populate variable with relay time and Populate variable with IP address boxes, use the drop-down lists to select the variables.

  5. To set the Description tab properties, refer to Description Tab Options.

  6. To set the Error Causes and On Error tab properties, refer to Step Error Handling.

  7. When finished, click OK to save settings and close the properties dialog box.

General Tab

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:

  • Milliseconds

  • Seconds (default)

  • Minutes

  • Hours

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.