WaitForText

Suspends script execution until the desired text is found in the host screen.

Parameters:

TextStr  -  The text string that you want to search for in the host screen.

RowValue  -  Specifies the start row position in the host screen where the search is to begin.

ColumnValue  -  Specifies the start column position in the host screen where the search is to begin.

TimeoutValue  -  The number of seconds to wait before returning with a "session is busy" error code.

Returns:

0 for success; or a non-zero error code.  See Error Codes for a complete listing of error code descriptions.

Remarks:

The WaitForText function can be used to verify that a specific host screen is being displayed before continuing with script execution.

Example:

Dim Host

 

Set Host = CreateObject( "BZWhll.WhllObj" )

 

Host.Connect "A"

ResultCode = Host.WaitForText( "S103XWRM", 1, 1, 5 )  'wait for text for 5 seconds

 

If ( ResultCode <> 0 ) Then

   Host.MsgBox "Host is not responding or incorrect Host!", 0

End If

 

Host.Disconnect