WINDOW DELETE

Delete Thoroughbred Basic Window

This directive deletes a selected Thoroughbred Basic Window or all Thoroughbred Basic Windows except the base screen.

Syntax

WINDOW DELETE (TBWin-name )[,ERR=line-ref|,ERC=error-code])

TBWin-name

is the name given to the Thoroughbred Basic Window by the WINDOW CREATE directive or

the keyword ALL which deletes all defined Thoroughbred Basic Windows except the base screen, which is not affected, or

the keyword ALLCLEAR which deletes all defined Thoroughbred Basic Windows except the base screen and clears the base screen as well.

line-ref

is the program line number or label to branch to if an error is produced by this function.

error-code

is a programmer-defined error code. Valid values are positive or negative whole numbers.

Remarks

This directive is generally available starting with release level 8.1.

Starting with release 8.2, when deleting Thoroughbred Basic Windows using either keyword ALL or ALLCLEAR, the Thoroughbred Basic Windows saved by using the WINDOW SAVE directive are deleted as well.

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.

If the currently open Thoroughbred Basic Window is specified, this directive performs the same function as the WINDOW POP directive.

When a Thoroughbred Basic Window is deleted, the Thoroughbred Basic Window and its contents are removed from the screen.

If an attempt is made to delete the main Thoroughbred Basic Window, an ERR=72 results.

Examples

WINDOW DELETE ("ALL")

removes the Thoroughbred Basic Window named ALL.

WINDOW DELETE (ALL)

removes all Thoroughbred Basic Windows.

See also

Other WINDOW directives
Additional WIN functions

From the Thoroughbred Basic Language Reference, Volume III: R–Z, version 8.9.1. Open this page in the PDF