Ping Machine Action

Description

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" TIMEOUT="number" RESULTVARIABLE="text">

Example

<AMPING HOST="server.domain.com" RESULTVARIABLE="responsetime">

General Tab Parameters

Hostname or IP: Specifies a 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.

Text, Required
MARKUP: HOST="http://www.networkautomation.com"

Time to wait: Specifies how long the step should wait (in milliseconds, second, minutes, or hours) before generating an error if there is no response from the server being "pinged."

Number, Required - Default YES
MARKUP: TIMEOUT="30"

Populate variable with relay time (in mlliseconds): Specify the variable to populate with the response time (in milliseconds.

Text, Optional - Default NONE
MARKUP: RESULTVARIABLE="varname"

Populate variable with IP address: Specify the variable to populate with the IP address.

See Also

Send Email, HTTP Download, Open a Webpage, HTTP Post