The CursorHomeColumn and CursorHomeRow are active in three different modes. In each case the cursor location is used to offset how recognition works, in relation to the cursor.
1.Standard Mode
2.Floating Window Mode
3.TTYPrompt Mode
Regardless of the mode, when using CursorHomeRow, set this value to the Cursor's "home" row position, which is the position found in the screen property active in the Screen Definition. This is usually visible and can be set by right-clicking on the cursor and selecting to set the value.
Standard Mode
Standard mode is when the FloatingWindow navigation boolean is false and the TTYPrompt VT recognition option is false.
In some environments, particularly character mode VT100 environments, recognition may need the cursor location in order to avoid "early recognition" of a screen. This is particularly troublesome when there is a pause during a screen transition and the current screen may be in the recognition list: the current screen will be recognized, even though the only thing that has happened is that the cursor may have moved one position to the right.
If you find that recognition is being "tripped-up" in a VTxxx emulation, you can use this value to ensure that recognition will wait for the cursor to "settle" to the home position.
Note: In Standard mode, the CursorHomeColumn and CursorHomeRow properties should not be used on screens where the cursor may start when the screen is displayed in more than one position, unless there is a ScreenDefinition for each condition/cursor home location.
If only the CursorHomeRow is defined, then any cursor position in that row will provide recognition; this is a good approach if field descriptions may vary in length, causing the cursor to appear in a different column on the home row. |
Floating Window Mode
When Floating Window mode is active (PopupWindow = true and FloatingWindow = true), the recognition is offset from the starting cursor location when a screen is displayed. This allows recognition for pop-up window overlays that can move in position (but still be the same window in terms of field data).
TTYPrompt Mode
A VT-style host (character mode) has a property that can be set on the screen definition to indicate that it is a simple prompt. CursorHomeRow is always required and determines how recognition is offset as prompts scroll down the screen.
