Programming with Reflection

image\rwnprg32.gif KeyboardErrorReset property

 

Syntax

object.KeyboardErrorReset
object.KeyboardErrorReset = Value

Data type

Boolean

 

Description

Returns (first syntax line) or specifies (second syntax line) how keyboard errors are processed. When a keyboard error occurs, an error message appears on the host status line (in 5250 sessions) or operator information area (in 3270 sessions). Standard terminal behavior requires that you press Reset to clear the error before you can resume data entry. Use this property to specify how you want keyboard errors processed.

This option is only applicable in data processing (not Text Assist) mode.

Values

The default is rcNoAutoReset.

rcAutoReset

You don't need to press Reset to clear a keyboard error—the next key you press clears the error, restores the previous error line data, and attempts to execute the keystroke as follows:

· If the cursor is in a valid input field and the key is a data key, the data is entered there if it is valid data for that field (for example, a numeric character in an input field that only accepts numbers).

· If the cursor is in a valid input field and the key is a function key, the key operation is executed.

· If the current cursor position is not in a valid input field and the key is a data key, the cursor is moved to the next valid input field and the data is entered there if it is valid data for that field.

· If the current cursor position is not in a valid input field and the key is a function key, the cursor is moved to the next valid input field and the key is ignored.

· If the current AS/400 screen contains no valid input fields, you'll see an error message with each keystroke you press, and no keystrokes are executed.

rcAutoResetNoMessage

No error is reported and Reflection attempts to execute the keystroke as follows:

· If the cursor is in a valid input field, the key is ignored. This is true for both data keys and function keys.

· If the cursor is not in a valid input field and the key is a data key, the cursor is moved to the next valid input field and the data is entered there if it is valid data for that field.

· If the cursor is not in a valid input field and the key is a function key, the cursor is moved to the next valid input field and the key is ignored.

· Use this value with caution, because it prevents you from being notified you of keyboard errors. If you use this value in 5250 sessions, it's recommended that you also change the value of the KeyboardErrorAlarm to True, so you'll hear an alarm (a beep) when you encounter a keyboard error.

rcNoAutoReset

Standard terminal behavior—you must press Reset to clear the error message from the 5250 error line before you can resume data entry.

 

image\jump.gif Keyword Index

image\popup.gif Related Topics

image\popup.gif Reflection products that use this property