Ping

The Ping action pings a specified host. It returns True if successful; otherwise, it returns False.

Note: The Actions Quick Reference provides a complete list of actions that you can print for easy reference.

Create a Ping action

1. On the Actions list, click Computer and select Ping.

2. Enter the target machine name or IP address in the Host field. Optionally, click the Magic Wand to use the Expression Builder. This string identifies the computer that is the destination for the ICMP echo message.

3. In the Timeout field, enter the value that specifies the maximum amount of time (milliseconds, seconds, or minutes) after sending the echo message to wait for the ICMP echo reply message. The time unit selected is always converted to milliseconds at run time. Optionally, click the Magic Wand to use the Expression Builder.

4. In the Save to field, enter the variable or data field that will be used to save the results from the ping. This field is required.

5. If needed, adjust the Run error task settings to fine tune how the action runs.

   • Run error task: A botflow containing an error task automatically runs the error task in the event of an error. If the botflow does not contain an error task, the botflow stops in the event of an error.
   • Stop on error: The botflow stops in the event of an error.
   • Ignore errors: The action is skipped in the event of an error and the botflow attempts to execute the next action.

6. (Optional) Add a Note to document special instructions or functionality.

7. Toggle the run switch to Run and click OK to execute and save the action.

Note: The run switch is set to Run by default. To create or modify this action without executing it, click the slider to change the option to Don't Run.  For more information, go to Action Builder.