How to Establish All Site Terminals

To make sure that all your users can use all your site terminals, you can establish all of the terminals by creating a task ID for each terminal and associating the task ID with a terminal definition. You may need to use the procedure described in this section if you have more terminals than you have already associated with task IDs. For reasons discussed in the following section, you may need to use the procedure twice.

This section assumes that you have identified all the terminals at your site, that you have terminal definitions for your site terminals, and that you have associated each terminal definition with at least one task ID. For more information on how to identify and specify terminal definitions please refer to the section titled How to Use Predefined Terminal Definitions.

Note

As an alternative to the procedure described below you can create a TERM.MAP file, which enables site users to select a terminal table before they run Thoroughbred Basic. For more information on the TERM.MAP File, please refer to the Thoroughbred Basic Customization and Tuning Guide – System Files.

Prepare for the Procedure

To prepare to establish all your site terminals to Thoroughbred Basic you can:

• Count all the terminals that may run Thoroughbred Basic. List the terminal types and the number of terminals that belong to each terminal type. Make sure you have identified or created a terminal definition for each terminal type.

• Determine which terminals can use Thoroughbred Basic Windows. If you have some terminals that can run Thoroughbred Basic Windows and some that cannot, you may have to use the following procedure twice: once to establish terminals that can use Thoroughbred Basic Windows and once to establish terminals that cannot. A terminal that runs applications that use Thoroughbred Basic Windows can also run applications that do not.

  Task IDs and their associated terminal tables are placed in the TCONFIG8 or TCONFIGW file. The TCONFIG8 file contains task IDs for terminals that can only run text-based Thoroughbred Basic and the TCONFIGW file contains task IDs for terminals that can run Thoroughbred Basic Windows as well as text-based Thoroughbred Basic. The following procedure can only update one of these files at a time.

  For more information on the TCONFIG8 and TCONFIGW Files, please refer to the Thoroughbred Basic Customization and Tuning Guide – System Files.

• Establish site naming conventions for task IDs. By default, the Terminal/Model Codes screen, which displays task IDs and their associated terminal definitions, starts with 8 task IDs, numbered T0 through T7. 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: X0 through X9, XA through XZ, Xa through Xz, and so on. You can specify up to 930 task IDs.

  If, for example, your site has terminals that can use Thoroughbred Basic Windows and terminals that cannot, you can decide that task IDs specified as Tx will identify terminals that can only run text-based applications and that task IDs specified as Wx will identify terminals that run both Thoroughbred Basic Windows applications and text-based applications.

• Make a list of the associations you will establish between task IDs and terminal definitions. You may need this information to determine how your users will login to Thoroughbred Basic. For more information on site login procedures, please refer to the section titled How to Establish Site Login Procedures.

Begin the Terminal Establishment 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 this manual. 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 establishing 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.

2

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

After you select 1 or 2 and press the Enter key, the install utility will display 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:

2. 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

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:

• Type a valid task ID. The Terminal/Model Codes screen contains a limited number of task IDs. If you have used all of these 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 some 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 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 number of task IDs displayed on the Terminal/Model Codes screen.

• 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 be displayed.

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 establishment procedure.

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

End the Terminal Establishment 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:

You can take one of the following actions:

• To run through the terminal establishment procedure again you can type 5 and press the Enter key. For more information on how to follow the procedure please refer to the section titled Choose the Type of Display.
• To leave the install utility and return to the operating system prompt, press the Enter key.

Test Site Terminals

After all site terminals are established, you can test some of the terminals to make sure they function properly. After you finish testing, you can use the information in the next section to tell site personnel how to login to Thoroughbred Basic.

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