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. Refer to 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

Set bzhao = CreateObject( "BZWhll.WhllObj" )
bzhao.Connect "A"
ResultCode = bzhao.WaitForText( "S103XWRM", 1, 1, 5 )  'wait 
for text for 5 seconds
If ( ResultCode <> 0 ) Then
   bzhao.MsgBox "Host is not responding or incorrect Host!", 0
End If
bzhao.Disconnect