The Receive I/O operation reads the data from the device, puts it into the Input buffer and then sets the pointer to the beginning of the buffer.
To display the Receive I/O Table Operation Properties window, first select the operation from the I/O Operation View. Then, open the Properties window for the operation by selecting Properties from the View menu.
The following fields are available:
Select Receive as the I/O Table operation type. For more information on available operations, see I/O Table Operations.
Select one of the following terminator characters to be used to signal the end of the reading to the Input buffer. The terminator is not placed in the Input buffer.
● Default. Uses the character specified as the default by the driver interface's Property pages.
● CR/LF. Carriage Return and Line Feed characters.
● CR. Carriage Return used to stop the reading.
● LF. Line Feed used to stop the reading.
● , . Comma only used to stop the reading.
● None. No terminator character used to stop the reading. If there is no terminator, then either the size or type is used to mark the end.
You can also enter your own terminator character as an escape sequence. For more information, see Escape Sequence String. If a terminator is required but not read from the device, an error is generated.
Check the SRQ box to force the receive operation to wait until the instrument signal SRQ and then read the data into the receive buffer.
Select the maximum number of bytes received from the device. Using the Default option uses the size specified in the driver's I/O Table Properties page. If you select another option, enter a number of Bytes in the edit box. The following options are available:
● Default - Maximum number of bytes is specified by I/O Table Properties page.
● Exact - Specify the exact number of bytes to receive. Not including the terminator. Any other number of bytes received will create a run-time error.
● At Least - Specify the minimum number of bytes to receive. The actual number of bytes cannot exceed that number + 64K.
● No More Than - Specify the maximum number that should be received.
Select or enter a value in milliseconds which represent the amount of time the operation waits for data before timing out. Selecting Default uses the value defined in the driver's I/O Tables Property page. Selecting Forever means that the operation does not time out and ATEasy will wait until it completes. Caution: this can hang the application forever.
Select the action to perform during an error:
● Default. Performs the action specified in the driver's I/O Tables Property page.
● Ignore. The operation ignores the error and continues to the next statement.
● Report. Report specifies the ATEasy default error handling. Generates recoverable run-time error that can be trapped using OnError module event or try/catch statements. If not trapping is done, the error is reported to the user and to the log control. The user can then select to Abort the application, Retry to repeat the I/O Table or Ignore to continue to the next statement.
For more information on errors, exceptions, and error handling, see Error and Exception Handling.
This is only used when the terminator is None. If checked, using IoTable to receive COM or WinSock data can work the same way as calling ComReceive or WsReceive with aioDisableComReceiveEarlyReturn or aioDisableWsReceiveEarlyReturn mode on respectively.
Enter a comment that more fully describes the operation. Click the Desc button to expand the Desc edit box. When you are finished entering the description, click the Desc button again to shrink the box.