Input operations typically are used for moving a data argument passed to the I/O Table from the Input buffer. After an Input operation, data from the Input buffer moves into a variable and the buffer pointer advances.
To display the Input 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. By default, the Properties window opens to the General page.
The following fields are available:
Select Input as the I/O Table operation type. For more information on available operations, see Types of Operations.
Select one of the following modes:
● ASCII to Parameter. Converts ASCII data from the Input buffer to an argument and advances the buffer pointer.
● Binary to Parameter. Converts Binary data from the Input buffer to an argument.
● ASCII to Return. ASCII data is converted from the Input buffer and set to the return value of the I/O Table. Only one Input operation in the I/O Table may use this.
● Binary to Return. Binary data is converted from the Input buffer and set to the return value of the I/O Table. Only one Input operation in the I/O Table may use this.
● Skip ASCII. Verifies existence of ASCII data and then advances. If there is no data, returns an error.
● Skip Binary. Verifies existence of binary data and then advances. If there is no data, returns an error.
● To File Parameter. Receives data and places in a file that will be a string parameter. You will have to pass the filename when calling the I/O table.
● Match String. You supply the string in the argument edit box. ATEasy finds and matches the string in the Input buffer and advances the pointer after it.
● Match String Parameter. Argument/Parameter. The string is entered as an argument and then passed as above.
The selection in the Mode list determines whether the edit box is a parameter or an argument:
When the Mode selection requires a parameter, select a parameter type. Depending on the selection and type, you can enter a maximum size for a string based parameter in the Max Size field, or a format mask for numeric parameters in the Format field. For text string types (String/BString) Max Size is shown.
Depending on the selections made in the Mode and Type lists one of the following edit boxes appears:
● Max Size. Enter a maximum number of characters for the argument. Only values equal to or less than this size are used. String lengths longer than this size are decreased until they match the size.
● Format. The Format field appears if the Type selected was numeric. Enter a format mask that is applied to the argument. For example using the format mask '-9999990.000 on the value 27, produces the output 27.000. If you leave the mask empty, it uses the default mask similar to the Str function. For more information on format masks, see Format Procedure. For more information on the Str function, see Str Procedure.
Select the action to perform during an error:
● Default. Performs the action specified in the driver's I/O Table Properties 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 statement. 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 Handling and Exceptions.
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.