Ipswitch WhatsUp Gold User Guide - Ipswitch Documentation Server

Ipswitch WhatsUp Gold User Guide
Keywords
Note: To comment out a line, use the # symbol as the first character of the line.
To send a string to a port, use the Send (on page 168)= keyword.
To expect a string from a port, use the SimpleExpect (on page 167)= or the Expect (on
page 167)= keyword.
To receive a conditional response for an error or success, use Flow Control Keywords
(on page 171).
Examples
If you have a TCP service to check, you need to do the following:
expect something on connection
send a command
check for a response
send something to disconnect
b. Script Syntax: Expect=Keyword
Expect=Keyword gives you flexibility to accept variable responses and pick out crucial
information using special control characters and regular expressions. If you do not need
flexibility, or are new to writing your own custom TCP/UDP scripts, you may want to use the
SimpleExpect (on page 167) keyword.
There are 4 variations of the Expect Keyword:
Expect. Returns true when the expected value is matched.
Expect(MatchCase). Only returns true when the case matches the expected value.
DontExpect. Returns true when the value is not found.
DontExpect(MatchCase). Returns true when the value is not found.
The Expect syntax is Expect=Response, where the Response is either specified as an exact
text string, or a mixture of regular expression rules (on page 172) and text. The Add/Edit
Expect Rule button helps you construct and test a regular expression response string. It
automatically chooses the variation of Expect for you based on options you select.
Note: Add/Edit Expect Rule does not aid in the generation of SimpleExpect keywords.
WhatsUp Gold v7 or v8 users: The ~, ^, ! and = = codes have been replaced with variations
on the Expect keyword itself. Migrated definitions are automatically converted.
167