How to Use Predefined Terminal Definitions

Note

If you have only one type of terminal at your site, and if it has been defined to Thoroughbred Basic, you can skip this section. Before you release Thoroughbred Basic to your user community, please use the information in the section titled How to Establish All Site Terminals to make sure you have established an appropriate number of terminal IDs for the users at your site.

If you have a variety of terminals at your site, you can use the information and procedure in this section to define all of them to Thoroughbred Basic. If Thoroughbred Basic has not predefined a terminal, you can use the procedure described in the section titled Create a Terminal Definition.

Begin the Terminal Specification Procedure

From the operating system prompt in your Thoroughbred Basic home directory type

./install

and press the Enter key. 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 specify the terminals at your site to Thoroughbred Basic type 5 and press the Enter key.

• If you have not activated Thoroughbred Basic the install utility will display the Activation Procedure screen. Please go to the following section.
• If you have activated Thoroughbred Basic, or if you are using a demonstration copy of Thoroughbred Basic, the install utility will display the Configuration Menu. Please skip the following section and go to the section titled Choose the type of display.

Check the Activation Procedure Screen

If you have not activated Thoroughbred Basic, the following screen will display:

        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 the following field:

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

Y If you plan to activate Thoroughbred Basic now, please refer to How to Get an Activation Key. In most cases, you will want to wait until you finish this task.

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

Note

To validate your copy of Thoroughbred Basic, you must get an Activation Key from Thoroughbred Software. From the installation or upgrade you have thirty days to obtain and enter an Activation Key. If thirty days elapse without activation, the installed version of Thoroughbred Basic will be restricted.

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

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

Press the Enter key to display the Configuration Menu.

Choose the Type of Display

The install utility displays the Configuration Menu:

SELECT TCONFIG FILE TO EDIT


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


SELECT OPTION (1 OR 2):

To specify a terminal type, you must decide whether the terminal will use Thoroughbred Basic Windows. 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 or Thoroughbred Basic Windows.

TCONFIG8 is the name of a file that is placed in the UTILS directory under the Thoroughbred Basic home directory. This file contains specifications and definitions that enable Thoroughbred Basic to manage your terminal hardware. For more information on the TCONFIG8 File, please refer to the Thoroughbred Basic Customization and Tuning Guide – System Files.

Thoroughbred Dictionary-IV is one of the application development systems. It can provide many resources to Thoroughbred Basic. For more information on these resources please refer to the section 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 text-based applications, you may want to choose this option.

2

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

TCONFIGW is the name of a file that is placed in the UTILS directory under the Thoroughbred Basic home directory. This file contains specifications and definitions that enable Thoroughbred Basic to manage your terminal hardware. For more information on the TCONFIGW File, please refer to the Thoroughbred Basic Customization and Tuning Guide – System Files.

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.

Choose the Modify Terminal Tables Option

To make use of terminals that Thoroughbred Basic has predefined you can check a list of terminal definitions. The install utility displays 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:

Check the Defined Terminal Table List Screen

The install utility displays 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.

This section of the manual assumes that your site terminals are displayed on the Defined Terminal Table List screen. If your terminals are listed, please write down their Model Codes.

If your terminals are not listed:

• You can determine whether a terminal emulates or is operationally compatible with one of the listed terminals, then write down the Model Code of the listed terminal. If you have to adjust the settings on your terminal, you may have problems with other programs and applications.
• You can determine whether a site 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.

If you decide to use one of these options you may need to use the information in How to Modify a Terminal Definition or the information in How to Create a Terminal Definition.

After you identify your site terminals and write down their Model Codes, check the field at the bottom of the screen:

1. 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:

Choose the Model Code Configuration Option

The install utility displays 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:

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

Type 2 and press the Enter key. The install utility will display the Terminal/Model Codes screen.

Associate Terminal IDs with Terminal Tables

Thoroughbred Basic defines terminal IDs, which are also called task IDs, to distinguish one terminal from another. In a multi-user environment, user tasks must be kept separate and distinct to avoid confusion. To help avoid these problems, and to make sure Thoroughbred Basic programmers and users use the appropriate terminal definition, you can associate a task ID with a particular type of terminal.

The install utility displays the Terminal/Model Codes screen:

               TERMINAL/MODEL CODES

  T0 LMC70E   LINK MC-70, PCKEYB    Tm W60E     WY60,PCKEYB,80C,WIN
  T1 LMC70E   LINK MC-70, PCKEYB    Tn W60E     WY60,PCKEYB,80C,WIN
  T2 LMC70E   LINK MC-70, PCKEYB    To LMC70S   LINK,MC-70,STANDARD
  T3 LMC70E   LINK MC-70, PCKEYB    Tp W60E     WY60,PCKEYB,80C,WIN
                                 .
                                 .
                                 .
  (CR) FOR MORE OR END TO SELECT:
                                 .
                                 .
                                 .

                    THIS TERMINAL IS T0


       22. ENTER TERMINAL ID:

The list of terminals and model codes may occupy more than one screen. Take one of the following actions:

• To scroll down through the list, press the Enter key. The THIS TERMINAL IS XX message is displayed at the bottom of the list.
• To specify a terminal ID without viewing the list, type END and press the Enter key. The THIS TERMINAL IS XX message is displayed.

You must enter a valid value in the following field:

22. ENTER TERMINAL ID:

The install utility places you in a loop that begins and ends with this message. You can take one of the following actions:

• If you have a terminal definition for the terminal, you are currently using you can type the terminal ID displayed on the screen in the THIS TERMINAL IS XX message. On the sample screen illustrated above the displayed terminal ID is T0, which usually refers to the system console.

• If you have a terminal definition for a terminal, you are not currently using you can select and type one of the terminal IDs that is not displayed in the THIS TERMINAL IS XX message.

  The Terminal/Model Codes screen contains a limited number of task IDs. If you have used these entire terminal IDs, you can specify a task ID with the Xx format:

  X is an uppercase letter. Valid values are T, U, V, W, X, Y, Z, A, B, E, H, I, J, K, and M.

  x is a numeral, an uppercase letter, or a lowercase letter. Valid values are 0 through 9, A through Z,

  and a through z.

  In most cases, terminal IDs are specified in the following order: T0 through T9, TA through TZ, Ta through Tz, U0 through U9, and so on. You can specify up to 930 task IDs.

• If you have created a terminal definition for all or most of your site terminals you can type ALL.

Note

The ALL command can only associate a terminal table with the listed task IDs. The Terminal/Model Codes screen contains a limited number of task IDs. If you need to specify more task IDs please refer to the section titled How to Establish All Site Terminals.

• If you have associated task IDs with terminal definitions and you want to see an updated display of the Terminal/Model Codes screen you can type TABLE.
• If you want to stop associating terminal IDs with terminal tables you can type END. The install utility will return you to the Terminal Menu. To continue the terminal definition procedure, please go the following section.

To associate at least one task ID with a terminal table, type a valid value other than END or TABLE and press the Enter key. The install utility diverges slightly at this point:

If you specified one terminal ID, such as T1, the install utility will display the following message:

23. DELETE (Y/N):

    Y means you want to delete the task ID from the displayed list. The install utility will return you to the

    preceding message, which asks you to enter a terminal ID.

    N means you want to specify a new terminal table that will be associated with the task ID.

    Because you want to associate a terminal table with a task ID, type N and press the Enter key.

If you specified ALL, or if you specified one terminal ID and specified N for the message above, the install utility will display the following message:

24. ENTER MODEL CODE (8 CHARACTERS MAX):

Type one of the terminal model codes you wrote down earlier and press the Enter key. The following message will display.

22. ENTER TERMINAL ID:

If you have finished associating terminal tables with task IDs you can type END and press the Enter key. Because you have specified at least one new association the install utility will display the following message:

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

Y means that the associations you specified will take effect. At least one task ID will be associated with a new terminal table.

N means that any of the values you specified will be discarded. There will be no new associations between task IDs and terminal tables. If you enter N you will return to the Terminal Menu. Please go to the following section to continue the terminal specification procedure.

Type Y and press the Enter key. The Terminal Menu will display.

Choose the Load Table into Terminal Option

Note

If you created a terminal table for a terminal you are not using now, please go to the following section to end the terminal specification procedure.

You can load the new terminal definition into the current Thoroughbred Basic Environment so that Thoroughbred Basic can make full and efficient use of the terminal you are currently using.

  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 load the terminal definition into the current Thoroughbred Basic environment, 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 = W60E):

Check the value displayed in the following field:

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

You can take one of the following actions:

• If XXXXXXXX is the model code for the terminal you are using now press the Enter key.
• If XXXXXXXX is not the model code for the terminal you are using now, type the appropriate model code and press the Enter key.

The new terminal definition is now part of the current Thoroughbred Basic environment. The install utility will return you to the Terminal Menu.

End the Terminal Specification Procedure

You have specified the types of terminals that the Thoroughbred Basic community at your site will use. You have associated each type of terminal with at least one task ID. Now, you can end the terminal specification procedure and leave the install utility.

The install utility displays 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 Thoroughbred Basic Utilities Menu:

mm/dd/yy - T0          THOROUGHBRED BASIC UTILITIES               hh:mm:ss
                             system information

 1)*APSD - PRINT DISC DIRECTORY        13) *MPSD - DISPLAY TASK ALLOCATION
 2)*BPSD - BUILD FILESET LIST          14) *NPSD - TERMINAL CONFIGURATOR
 3)*CPSD - COMPARE PROGRAMS            15) *OPSD - DEFINE FILES
 4)*DPSD - RENAME PROGRAMS/FILES       16) *PPSD - RENUMBER PROGRAMS
 5)*EPSD - ERASE PROGRAMS/FILES        17) *QPSD - STRING SEARCH AND REPLACE
 6)*FPSD - DISPLAY FILE PARAMETERS     18) *RPSD - OBJECT FILE MAINTENANCE
 7)*GPSD - GHOST TASK COMMUNICATIONS   19) *SPSD - TRANSFER PROGRAMS/FILES
 8)*HPSD - LIST PROGRAMS ON TERMINAL   20) *TPSD - FILE TRANSFER AND EXPAND
 9)*IPSD - HEX FILE DUMP               21) *XPSD - CHANNEL CROSS REFERENCE
10)*JPSD - INITIALIZE DISC ENVIRONMENT 22) BASIC - GOTO BASIC CONSOLE MODE
11)*KPSD - LIST PROGRAMS               23) OS    - EXIT TO OPERATING SYSTEM
12)*LPSD - LIST DISC DIRECTORY


ENTER SELECTION OR CR TO END:

You must enter a valid value in the following field:

ENTER SELECTION OR CR TO END:

Type the number for the EXIT TO OPERATING SYSTEM command 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.

To finish establishing your entire site terminals with Thoroughbred Basic please go to the section titled How to Establish All Site Terminals.

From the Customization and Tuning Guide: Devices, version 8.9.1. Open this page in the PDF