.WaitForCommString

Syntax

WaitForCommString "CommString", "Timeout", "Count"

Description

Begins a wait that is satisfied by the reception of the specified string from the host. The operation containing the command is paused until the data communication string is received or the timeout expires.

When connecting to VT and HP character mode hosts, you can wait for datastream sequences that include nonprintable characters. As the terminal processes characters, you can copy and paste text from the Model Debug Messages dialog box into the String box.

Notes:

Using the right mouse button, open the shortcut menu to copy and paste text from the Model Debug Messages dialog box. You can also use the Ctrl-C keystroke to copy the text; however, do not use the Ctrl-V keystroke to paste the text. Instead, use the Paste button provided next to the String box.
Often the best synchronization for VT and HP is in the datastream itself. Coupled with the WaitForMultipleEvents command, it will enable you to be very deterministic about synchronization.
Use WaitForCommString only if you are connecting to your host using a host application that uses character mode datastreaming rather than block mode. This applies to VT and HP character mode models only.
If you are connecting directly to a host, use WaitForDisplayString.
You can also record a login command list to determine which command is appropriate for your connection.

Command Parameters

Count	Argument type: Numeric
	Specifies the number of times a string is received from the host. The default value is 1.

String	Argument type: String
	The string that can terminate the wait. This string must be received from the host. Note: Use the right-mouse button menu to copy and paste text instead of the Ctrl-C and Ctrl-V keystrokes. A Paste button appears when the Host Integrator accepts special characters.

Timeout	Argument type: String
	Specifies an interval of time in HH:MM:SS format that can terminate the wait. If this method times out, an error occurs.