Host Find String

This Host Interface tool returns the row and column coordinates for an instance of a string you specify. Searching begins at row 1, column 1, unless you select the Reverse search option where it begins at the lower right corner.

Inputs

Host Connection

The name of the connection created by the Host Connect tool.

String to Find

The string to search for on the screen.

Number of occurrences

The number of occurrences to search for before returning the string position. For example, if you specify 2, this tool returns the coordinates for the beginning of the second match.

Case-sensitive Search

Select this option if you want to search for an exact match to the specified string. Do not select this option if you are not concerned with an exact match on case.

Reverse Search

Select this option if you want to start searching at the lower-right coordinate and search backwards. You might use this option if there are multiple occurrences of an item on the screen, and you want to find the last one. Or, perhaps you know that an item will be in the lower right quadrant of the screen, so a reverse search will be (slightly) faster than a forward search.

Outputs

Row

The row coordinate for the match’s first character.

Column

The column coordinate for the match’s first character.

Exit Paths

Success

This step takes the Success exit path if a match was found.

Failure

This step takes the Failure exit path if the host connection is invalid, or becomes invalid during the search. This occurs if the mainframe disconnects for some reason.

Not Found

This step takes the Not Found exit path if a match was not found between the search string and a string in the screen searched.