Skip to content
Thoroughbred Software InternationalThoroughbred Software InternationalThoroughbred DocumentationDocs

Establish Your System Console

You must configure Thoroughbred Basic to recognize your system console so that Thoroughbred Basic can make full and efficient use of all terminal features. How you accomplish this task depends on whether you are installing or upgrading Thoroughbred Basic:

  • If you are installing, please use the information in the following subsection.
  • If you are upgrading, please turn to “For an Upgrade”.

For an Installation

Section titled “For an Installation”
Note:
You may need to provide the install utility with information about the system console. Knowing the value specified for your operating system's TERM variable may help you make informed decisions. For more information, please get the technical reference for the terminal and keep it handy as you perform this task.

After you begin the installation, the install utility will display the Installation and Updating Procedures Menu:

  Thoroughbred BASIC Installation and Updating Procedures




              1)  Install New System
              2)  Install/Update User Logins
              3)  Install/Update BASIC Directories
              4)  Install/Update BASIC Printers
              5)  Install/Update BASIC Terminals
              6)  Install/Update BASIC Ghost Tasks




              Enter Selection (1 - 6) or <CR> to end:

You must enter a valid value in the following field:

Enter Selection (1 - 6) or <CR> to end:

To install and configure your system console, type 5 and press the Enter key.

For a full copy

If you are installing a full copy of Thoroughbred Basic, the following screen will be displayed.

       Thoroughbred BASIC Activation Procedure




  This system contains a temporary installation of
  Thoroughbred BASIC.
  You have less than 'nn' days before the number
  of active users is restricted to 3.




              SSN = XXXXXXXXX-XX
              Installation Code = XXXXXXXXX


  Do you want to enter the Activation Key? (Y/N):

You must enter a valid value in one field:

Do you want to enter the Activation Key? (Y/N)

Y If you plan to activate Thoroughbred Basic now, please refer to Get an Activation Key from Thoroughbred Software International. In most cases, you will want to wait until the installation is complete.

N You do not want to enter the Activation Key now. You can finish the installation before you activate Thoroughbred Basic.

Note: To validate your copy of Thoroughbred Basic, you must get an Activation Key from Thoroughbred Software. You have thirty days to obtain and enter an Activation Key. If thirty days elapse without activation, site use of Thoroughbred Basic will be restricted.

If you select N the install utility will display the following message:

Thoroughbred BASIC   Level 8.9.1   nn User
DEPRESS THE CARRIAGE RETURN KEY:

Press the Enter key to display the Configuration Menu.

SELECT TCONFIG FILE TO EDIT




   1. TCONFIG8 (NON-WINDOWS)
   2. TCONFIGW (WINDOWS ONLY)




SELECT OPTION (1 OR 2):

You must enter a valid value in the following field:

SELECT OPTION (1 OR 2):
1
is the TCONFIG8 option, an option that does not enable you to use Dictionary-IV 8.9.1 or Thoroughbred Basic Windows.

TCONFIG8 is the name of a file that is placed in the UTILS subdirectory under the Thoroughbred Basic home directory. This file contains specifications and definitions that enable Thoroughbred Basic to manage your terminal hardware.

Thoroughbred Dictionary-IV is the data dictionary component of the Thoroughbred OPENworkshop application development system. It can provide many resources to Thoroughbred Basic. For more information on these resources please refer to the chapter on the Dictionary-IV Interface in the Thoroughbred Basic Developer Guide.

Thoroughbred Basic Windows is a windowing system that enables you to create pop-up help systems, menu systems, and other program features commonly associated with windowing systems. For more information on Thoroughbred Basic Windows please refer to the Thoroughbred Basic Developer Guide.

If you have very old terminals, if you do not plan to use Dictionary-IV, or if you plan to develop applications that are text-based and linear, you may want to choose this option.

2 is the TCONFIGW option, which enables you to use Dictionary-IV 8.9.1 and Thoroughbred Basic.

TCONFIGW is the name of a file that is placed in the UTILS subdirectory under the Thoroughbred Basic home directory. This file contains specifications and definitions that enable Thoroughbred Basic to manage your terminal hardware.

If you have terminals with graphics capabilities, if you plan to use Dictionary-IV, or if you plan to develop applications that make use of the Thoroughbred Basic Windows graphical user interface, you must choose this option.

After you select 1 or 2 and press the Enter key, the install utility will display the Terminal Menu:

  1. MODIFY TERMINAL TABLES
  2. MODIFY TERMINAL/MODEL CODE CONFIGURATION
  3. LOAD TABLE INTO TERMINAL




  2. SELECT OPTION (1, 2, OR 3):

You must enter a valid value in the following field:

2. SELECT OPTION (1, 2, OR 3):

To identify your terminal, type 1 and press the Enter key. The install utility will display the Defined Terminal Table List screen:

                  DEFINED TERMINAL TABLE LIST


   ADDSUP     ADDS VIEWPOINT        MICOTERM   MICRO TERM
   ADM-3A     LSI MODEL ADM-3A      PIXEL      PIXEL CONSOLE TERM
   ALTOS-II   ALTOS-II TERMINAL     PROGTERM   BURROUGHS/CONV.PT
   ALTOS-V    ALTOS-V TERMINAL      PT200      PRIME PT200


   FASTRK30   4-PHASE FASTTRAK 30   TVI920     TELEVIDEO 920
   FORTUNE    FORTUNE               TVI950     TELEVIDEO 950
   HP-2392    HP2392 DISPLAY        VT100      DEC VT100
   HP-98785   HP98785A DISPLAY      VT131      DEC VT131


3. C-CREATE M-MODIFY D-DELETE L-LIST TABLE - ENTER C, M, D, OR L:

Each terminal definition has two parts: the Model Code and the terminal description. The Model Code precedes the description. For example, the Model Code for a DEC VT100 terminal is VT100.

If the terminal type of your system console is listed, please write down the Model Code.

If your terminal type of your system console is not listed:

  • You can determine whether your terminal emulates one of the listed terminals, then write down the Model Code of the listed terminal. If you have to adjust the settings on your system console, you may have problems with other programs and applications.
  • You can determine whether your terminal is analogous to one of the listed terminals, then write down the Model Code of the listed terminal. Even if your terminal is a good match for one of the listed terminals, you may have minor display problems when you run Thoroughbred Basic.
  • You can temporarily use one of the options above, then create a terminal type when you customize and tune Thoroughbred Basic. To learn how to create or modify terminal types and terminal tables, please refer to the information in the Thoroughbred Basic Customization and Tuning Guide.

After you identify your terminal and write down its Model Code, check the field at the bottom of the screen:

3. C-CREATE, M-MODIFY, D-DELETE, L-LIST TABLE - ENTER C, M, D, OR L:

Type END and press the Enter key. The install utility will return you to the Terminal Menu:

  1. MODIFY TERMINAL TABLES
  2. MODIFY TERMINAL/MODEL CODE CONFIGURATION
  3. LOAD TABLE INTO TERMINAL




  2. SELECT OPTION (1, 2, OR 3):

You must enter a valid value in the following field:

2. SELECT OPTION (1, 2, OR 3):

Thoroughbred Basic needs a terminal ID to finish terminal configuration. To associate your terminal ID with the terminal table, type 2 and press the Enter key. The install utility will display the Terminal/Model Codes screen:

                    TERMINAL/MODEL CODES




  T0 WY-60  WYSE 60 IBM KEYBOARD   T4 WY-60  WYSE 60 IBM KEYBOARD
  T1 WY-60  WYSE 60 IBM KEYBOARD   T5 WY-60  WYSE 60 IBM KEYBOARD
  T2 WY-60  WYSE 60 IBM KEYBOARD   T6 WY-60  WYSE 60 IBM KEYBOARD
  T3 WY-60  WYSE 60 IBM KEYBOARD   T7 WY-60  WYSE 60 IBM KEYBOARD


                    THIS TERMINAL IS T0




       22. ENTER TERMINAL ID:

You must enter a valid value in the following field:

22. ENTER TERMINAL ID:

Since you are configuring this terminal, type the terminal ID displayed on the screen and press the Enter key. You have associated the terminal ID with the terminal table. The install utility will generate a message:

23. DELETE (Y/N)?:

Type N and press the Enter key. The install utility will generate a message:

24. ENTER MODEL CODE (8 CHARACTERS MAX):

Type the terminal model code you wrote down earlier and press the Enter key. The following message will be displayed.

22. ENTER TERMINAL ID:

To return to the Terminal Menu, type END and press the Enter key.

Because you have created a new terminal table the install utility will display the following message:

SAVE NEW TERMINAL/MODEL TABLE (Y/N):

Type Y and press the Enter key. The Terminal Menu will be displayed:

  1. MODIFY TERMINAL TABLES
  2. MODIFY TERMINAL/MODEL CODE CONFIGURATION
  3. LOAD TABLE INTO TERMINAL




  2. SELECT OPTION (1, 2, OR 3):

You must enter a valid value in the following field:

2. SELECT OPTION (1, 2, OR 3):

You have associated a terminal ID with a terminal table. Now, you must load the terminal table into the current operating environment so Thoroughbred Basic can make full and efficient use of your terminal. Type 3 and press the Enter key. The install utility will display the Load Terminal with New Terminal Table screen.

                 LOAD TERMINAL WITH NEW TERMINAL TABLE


    ADDSUP     ADDS VIEWPOINT        MICOTERM   MICRO TERM
    ADM-3A     LSI MODEL ADM-3A      PIXEL      PIXEL CONSOLE TERM
    ALTOS-II   ALTOS-II TERMINAL     PROGTERM   BURROUGHS/CONV.PT
    ALTOS-V    ALTOS-V TERMINAL      PT200      PRIME PT200


    FASTRK30   4-PHASE FASTTRAK 30   TVI920     TELEVIDEO 920
    FORTUNE    FORTUNE               TVI950     TELEVIDEO 950
    HP-2392    HP2392 DISPLAY        VT100      DEC VT100
    HP-98785   HP98785A DISPLAY      VT131      DEC VT131


          25. ENTER MODEL CODE TO LOAD (CR = WY-60):

Check the value displayed in the following field:

25. ENTER MODEL CODE TO LOAD (CR = XXXXXXXX):

If XXXXXXXX is the model code you wrote down earlier, press the Enter key. The install utility will return you to the Terminal Menu:

  1. MODIFY TERMINAL TABLES
  2. MODIFY TERMINAL/MODEL CODE CONFIGURATION
  3. LOAD TABLE INTO TERMINAL




  2. SELECT OPTION (1, 2, OR 3):

You must enter a valid value in the following field:

2. SELECT OPTION (1, 2, or 3):

Type END and press the Enter key. The install utility will display the Installation and Updating Procedures screen:

  Thoroughbred BASIC Installation and Updating Procedures




              1)  Install New System
              2)  Install/Update User Logins
              3)  Install/Update BASIC Directories
              4)  Install/Update BASIC Printers
              5)  Install/Update BASIC Terminals
              6)  Install/Update BASIC Ghost Tasks




              Enter Selection (1 - 6) or <CR> to end:

You must enter a valid value in the following field:

Enter Selection (1 - 6) or <CR> to end:

To leave the install utility and return to the operating system prompt, press the Enter key.

You have configured Thoroughbred Basic to use your system console. The values you specified have been placed in the TERMINAL file in the Thoroughbred Basic home directory.

Please turn to Test the system, to continue your installation.

For an upgrade

Section titled “For an upgrade”

You can establish your system console, as well as eliminate most customization and tuning tasks, by copying or restoring a set of files that contain information about how your site configured the previous version of Thoroughbred Basic.

After you begin the upgrade, the install utility will display the Installation and Updating Procedures Menu:

  Thoroughbred BASIC Installation and Updating Procedures




              1)  Install New System
              2)  Install/Update User Logins
              3)  Install/Update BASIC Directories
              4)  Install/Update BASIC Printers
              5)  Install/Update BASIC Terminals
              6)  Install/Update BASIC Ghost Tasks




              Enter Selection (1 - 6) or <CR> to end:

You must enter a valid value in the following field:

Enter Selection (1 - 6) or <CR> to end:

To leave the install utility and return to the operating system prompt, press the Enter key.

You can use one of the following methods to configure your system console:

  • If you loaded Thoroughbred Basic files into a new home directory so that you could run two systems, you can copy the IPLINPUT and TERMINAL files from the old home directory into the new home directory. Then, copy the TCONFIG, TCONFIG8, and TCONFIGW files from the old UTILS subdirectory, which is under the old Thoroughbred Basic home directory, to the new UTILS subdirectory. You may not have all three of the TCONFIG files.
  • If you overwrote a previous version of Thoroughbred Basic with Thoroughbred Basic you can restore some backup files: first, restore the IPLINPUT and TERMINAL files and put them in the Thoroughbred Basic home directory; then, restore the TCONFIG, TCONFIG8, and TCONFIGW files and place them in the UTILS subdirectory, which is under the Thoroughbred Basic home directory. You may not have all three of the TCONFIG files.

From the Thoroughbred Basic for UNIX and Linux Installation Guide, version 8.9.1. Open this page in the PDF