Skip to content

WIN ( GETLIST )

Get List of Active Thoroughbred Basic Windows

This string function returns a list of the names of the active terminal Thoroughbred Basic Windows for this task.

WIN ( GETLIST )

This function is generally available starting with release level 8.1.

If you use this function 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.

The format of the returned string is:

Byte(s) Description
1-2 Binary count of the number of Thoroughbred Basic Windows
3-10 8-character name of the first Thoroughbred Basic Window
11-18 8-character name of the second Thoroughbred Basic Window
19-n 8-character names of additional Thoroughbred Basic Windows

If no Thoroughbred Basic Windows are defined the returned string contains 10 characters, $00 01 30 20 20 20 20 20 20 20$, indicating the presence of one Thoroughbred Basic Window whose name is “0 “ (eight-character name), the default or base Thoroughbred Basic Window. This Thoroughbred Basic Window is defined by Thoroughbred Basic when it is initialized with a Thoroughbred Basic Window task and given the name 0. This Thoroughbred Basic Window can be referred to by its name in those functions and directives that provide for name selection. The name of this Thoroughbred Basic Window cannot be changed.

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