Script Command: RECV

RECV [-t:xX] [arg1]

This command allows the script to wait for some sequence of characters. The characters can be ASCII or binary (specified with ASCII-coded-hex), or the command can be set up to just wait for some number of characters, ignoring what characters are actually received. Without specifying -x or -X, this command is essentially the same as the "wait" portion of the SEND command. The added capability that this provides is the ability to wait for a binary sequence or just some number of incoming characters.

Options:

-t {seconds}    specify some number of seconds after which RECV will giveup waiting
                for a prompt (see note below)
-X              wait for some number of characters as specified by arg1
-x              treat arg1 as a character sequence of ascii-coded-hex and wait for
                that binary stream.

If the -t option is used in this command, then upon completion, the shell variable SCR_TIMEOUT will be loaded with either "TRUE" or "FALSE". The script can use this to know if a timeout actually occurred (SCR_TIMEOUT="TRUE") or the command received what it was expecting to receive within the allocated time (SCR_TIMEOUT="FALSE").

NOTE: -x and -X options are mutually exclusive. Don't use both in one command instance.