WINDOW IOREGION

Create Protected Region

This directive restricts terminal input and output to a selected portion of the current Thoroughbred Basic Window. In effect, it protects the current Thoroughbred Basic Window outside the IOREGION from change.

Syntax

WINDOW IOREGION ( CREATE, width, height, col1, row1 )

WINDOW IOREGION ( DELETE )

CREATE: is the keyword to cause an IOREGION to be defined within the currently active Thoroughbred Basic Window.
width: is any positive integer in the range of 1 to the maximum number of columns in the currently active Thoroughbred Basic Window's text area, designating the total width of the unprotected region.
height: is any positive integer in the range of 1 to the maximum number of rows in the currently active Thoroughbred Basic Window's text area, designating the total height of the unprotected region.
col1: is any positive integer in the range of 0 to the maximum number of columns in the Thoroughbred Basic Window minus 1, designating the leftmost Thoroughbred Basic Window column of the unprotected area.
row1: is any positive integer in the range of 0 to the maximum number of rows in the Thoroughbred Basic Window minus 1, designating the topmost Thoroughbred Basic Window row of the unprotected area.
DELETE: is the keyword to cause any defined IOREGION in the currently active Thoroughbred Basic Window to be deleted, leaving the entire Thoroughbred Basic Window available for terminal input and output.

Remarks

This directive is generally available starting with release level 8.1.

Starting with release level 8.2, this directive deletes all the panels created by WINDOW PANEL.

If you use this directive but Thoroughbred Basic Windows is not enabled, an ERR=70 results. For information on how to enable Thoroughbred Basic Windows, please refer to the information on TCONFIG files and IPL files in the chapter on System Files in the Thoroughbred Basic Customization and Tuning Guide.

If this task is configured for Thoroughbred Basic Windows, only the standard set of Thoroughbred Basic terminal mnemonics should be used to send output to the terminal. Using direct hexadecimal escape sequences to control the terminal screen may cause the Thoroughbred Basic Windows Manager to lose knowledge of cursor position and character attributes. For more information on terminal mnemonics, please refer to the Thoroughbred Basic Customization and Tuning Guide.

The CREATE option causes the cursor to be positioned in the upper left corner of the IOREGION defined, and all subsequent cursor positioning while within this IOREGION is relative to the IOREGION boundaries (0,0 is the upper left corner of the IOREGION, not the Thoroughbred Basic Window).

The data already displayed in the area defined by the IOREGION remains unchanged by the CREATE option.

Examples

WINDOW IOREGION ( CREATE, 60, 4, 10, 2 )

protects the current Thoroughbred Basic Window from terminal input and output with the exception of a 60-column wide, 4-row high, area starting at the 11th column and the 3rd row from the top left of the currently active Thoroughbred Basic Window.

WINDOW IOREGION

Syntax

Remarks

Examples

See also