How to Modify a Terminal Definition

You may need to change parts of an existing terminal definition to use the full set of terminal capabilities or to correct a display problem. To modify a terminal definition, you can use the following procedure.

Identify What You Plan to Change

Make a list of the features you plan to incorporate in the terminal definition, display problems you have encountered, or keystroke sequences that do not perform the appropriate function.

Check the Terminal Documentation

To modify a terminal definition, you will need to provide some technical information to Thoroughbred Basic. Please get the technical reference for the terminal. Make sure the documentation includes lists of terminal functions, key codes, and escape sequences. If these specifications are missing, please contact your terminal manufacturer for the relevant information.

If you have a full set of terminal specifications, compare the changes you plan to make against the capabilities of the terminal. If your terminal does not support the features you would like to include in the terminal definition, please change your list of modifications.

Begin the Modification 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 define a terminal 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 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 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 modifying the terminal definition 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 date 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 begin defining a terminal 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 Modify Terminal Tables 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):

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. Because you are modifying a terminal definition this section of the manual assumes that your terminal is displayed on the Defined Terminal Table List screen.

You must enter a valid value in the following field:

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

Because you plan to modify a terminal table, consider only the following options:

M

is short for MODIFY a terminal table. You can add, delete, or replace table specifications to change an existing terminal definition. In most cases you will use this option to supplement the capabilities of a terminal that is already defined.

If you have a list of the specifications that compose the terminal definition, please refer to the section titled Begin to Modify the Terminal Definition.

L

is short for LIST a terminal table. You can print the list of terminals on the Defined Terminal Table List screen or print a terminal table, which contains the complete list of specifications for one defined terminal.

To print a list of the specifications in a terminal definition, please go to the next section titled List the Terminal Table. This list will provide information to help guide you to appropriate prompts and save you some time.

Note

Before you can list a terminal table, you must define at least one printer to Thoroughbred Basic. For more information on how Thoroughbred Basic works with printers please refer to How to Establish Printers.

END

means end the terminal definition procedure. If you select this option you will return to the Terminal Menu, which is described in the section titled Choose the Modify Terminal Tables Option.

List the Terminal Table

Note

Before you can list a terminal table, you must define at least one printer to Thoroughbred Basic. For more information on how Thoroughbred Basic works with printers please refer to How to Establish Printers.

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:

You must enter a valid value in the following field:

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

To list defined terminal tables, type L and press the Enter key. The install utility will display the following message:

TABLE LISTING ONLY (Y/N)?

Y

You can print the list of terminals displayed on the Defined Terminal Table List screen. Only the Model Code and the terminal description will be printed.

N

You can print the list of values specified in one terminal table. These values can include the numeric values associated with keystrokes, values associated with printer mnemonics, and so on.

END

means end the list procedure. If you have not used the information in How to Establish Printers to define a printer to Thoroughbred Basic, you may want to choose this option.

If you type END and press the key you will return to the Terminal Menu screen, which is described in the section titled Choose the Modify Terminal Tables Option.

Type N and press the Enter key. If site printers are validly defined to Thoroughbred Basic, the following message will be displayed:

ENTER TERMINAL TABLE:

Type the Model Code for the terminal definition and press the Enter key. The install utility will display the following message:

SELECT PRINTER: XN . . .

XN

is the printer code of a printer defined to Thoroughbred Basic.

Type one of the displayed printer codes and press the Enter key. The install utility will print all of the specifications in the terminal table; it will also display the specifications on your terminal screen. After the information is printed, you will return to the Defined Terminal Table List screen.

Get the printed copy of the terminal table specifications. Each specification is associated with a prompt number. Make a note of the specifications you plan to change and the associated prompt numbers. Please refer to the following section to continue modifying your terminal.

Note

If site printers are not defined to Thoroughbred Basic, if site printers are invalidly defined, or if site printers are busy, the following message will be displayed:

PRINTER IN USE (HIT CR . . )

This message usually signifies a printer definition error. If you press the Enter key the message will redisplay; if you do not press the Enter key the message will redisplay. To escape from this loop, press Ctrl-b. The following message will be displayed:

Return to UNIX (Y/N)? or Debug (D)?

Y

means that you will leave the install utility and return to the operating system prompt in the Thoroughbred Basic home directory. Y is the only option that enables you to escape from the message loop.

N

means that you will remain inside the loop and continue to receive the message. To escape the loop, you will have to press Ctrl-b then enter Y to return to your operating system prompt.

D

is short for debug. In this situation the debug facility will place you inside the loop and you will continue to receive the message. To escape the loop you will have to press Ctrl-b then enter Y to return to your operating system.

Type Y and press the Enter key. You will leave the install utility and return to the operating system prompt in the Thoroughbred Basic home directory. To continue this procedure, please refer to the section titled Begin the Modification Procedure.

Begin to Modify the Terminal Definition

Note

Make sure you have your list of changes, the printed list of terminal table specifications, and technical references for your terminal close at hand.

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:

You must enter a valid value in the following field:

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

To modify the terminal definition type M and press the Enter key. The install utility will display the following message:

4. ENTER TERMINAL TABLE:

Take one of the following actions:

• Type the Model Code for your terminal definition and press the Enter key.
• Type END and press the Enter key. You will halt the modification procedure and return to the Terminal Menu. If you want to resume modifying the terminal definition, please refer to the section titled How to Modify a Terminal Definition.

After you enter a valid value other than END the install utility will display the following message:

– OLD NAME –> terminal description
6. ENTER TERMINAL NAME (20 CHARACTERS MAX):

terminal description is a description associated with a Model Code. If you entered a Model Code for the preceding message, this field contains a brief terminal description. If you did not enter a Model Code for the preceding message, this field is blank.

Take one of the following actions:

• Type a description of your terminal and press the Enter key. A valid terminal description is 1 through 20 alphanumeric characters long.

  If you enter an invalid terminal description, the install utility will redisplay this message.

• Press the Enter key to accept the current value of terminal description. If the field is blank, you will accept an empty terminal description.

• Type END and press the Enter key. You will halt the terminal definition procedure and return to the Terminal Menu. If you want to resume the terminal definition procedure, please refer to the section titled Choose the Type of Display.

If you do not specify END at this time the install utility will assume that you want to finish the terminal definition procedure. You are not committed to saving or using the terminal definition you create but you are committed to finishing the procedure described in the next few sections.

After you enter a valid value other than END, the install utility will display the following message:

– OLD VALUE –> xx

7. ENTER TERMINAL BACKSPACE CODE (HH):

The modification procedure continues in the following section.

Modify Specifications

The install utility displays the following message:

– OLD VALUE –> xx
7. ENTER TERMINAL BACKSPACE CODE (HH):

Each message in this procedure enables you to change a terminal table specification. Because each message is numbered, you can use the printed list of terminal table specifications to determine the number of each message. To go to the appropriate message, use the following command:

BACK nn

nn

specifies the number of the specification you plan to change. Valid values range from 7 through 38.

If you specify a number less than 7, you will be returned to the message numbered 7, which is listed above. If you specify a number greater than 38, the message numbered 38 will be displayed.

The sections titled Begin to Modify the Terminal Definition through Choose the Load Table into Terminal Option describe the specifications you can reach with the BACK nn command. After you enter the modifications, you plan to make, you can enter the BACK 38 command to go to the last message in the range. After you specify or accept a value for the message numbered 38, the List of Defined Mnemonics screen will be displayed:

                    LIST OF DEFINED MNEMONICS


BU  BV  CE  CF  CH  CL  CN  CO  CR  CS  DN  DO  EB  EG  EP  ER  ES
EU  FF  G0  G1  G2  G3  G4  G5  G6  G7  G8  G9  GA  GB  GC  GD  GE
GF  LD  LF  LI  NS  RB  RC  RM  SB  SE  SF  SS  TR  VT  WS  YN  A1
A2  A4  A6  A8  BB  BD  BF  BG  BR  VG  BS

39, DEFINE MNEMONIC CODE MM:

If you plan to modify terminal mnemonics, please refer to the information in the sections titled Consider Terminal Mnemonics and Specify Terminal Mnemonics. If you do not plan to modify terminal mnemonics, or if you have finished entering new specifications for mnemonics, type END and press the Enter key. Please go to the following section to continue the modification procedure.

Save the Terminal Definition

After you have finished specifying new values for terminal table specifications, the modification procedure is complete. The install utility displays the following message:

40. SAVE NEW TERMINAL TABLE (Y/N)?

Y means the install utility will save the terminal definition.

N means the terminal definition is not saved. The install utility will return you to the Terminal Menu. You can take one of the following actions:

• If you plan to create a terminal definition, please refer to the section titled Choose the Modify Terminal Tables O**ption.
• If you plan to stop creating a terminal definition, please refer to the section titled End the Modification Procedure.

To save the terminal definition type Y and press the Enter key. The install utility will display the following message set:

GENERATING TERMINAL CONTROL TABLE

FLAG WORD
POSITION PARAMETERS
SCREEN SIZES
SPECIAL CHARACTERS
CURSOR MASK
IGNORE CHARACTERS
FUNCTION KEYS
MNEMONICS

TERMINAL CONTROL TABLE NAME

SUCCESSFULLY GENERATED

Press <Return> to continue

Press the Enter key. The install utility will display the following message set:

TERMINAL TABLE NAME

PROPERLY SAVED

Press any key to continue.

Press the Enter key. The install utility will display the Terminal Menu. To continue the terminal modification procedure, please go to the following section.

Choose the Load Table into Terminal Option

Note

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

You can load the modified terminal definition into the current Thoroughbred Basic environment so that Thoroughbred Basic can make full and efficient use of your terminal.

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 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 modified terminal definition is now part of the current Thoroughbred Basic Environment. 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):

To end the terminal definition procedure, please go to the following section.

End the Modification Procedure

You have finished modifying a terminal definition and made the modified terminal table available to Thoroughbred Basic. You can end the terminal modification 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.

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