KernelDebugRef - The T Terminal Emulator

The Kernel Debugger uses the T Terminal Emulator to communicate with the machine to be debugged, also known as the MUT (Machine Under Test).

You can also use T to send and receive ASCII files.

All functions of T are listed on the Help menu. Press F1 to view the Help menu, which is shown below:

 TERMINAL - OS/2 ASCII Terminal Program

 Version 2.00.00

F1 or ALT-H   Help
F2            Terminal Setup
F3            Sending Files
F4            Pausing and Scrolling
F6            Receiving Files
F8  or ALT-X  Exit terminal program

Command-Line Syntax

To display help for command-line syntax, type `T -?` at the prompt.

OS/2 Terminal program
Version 2.00.00
November 1, 1991

Valid command line switches:
  -L[ines]X      X={lines}
  -C[om]N        N={1..8}
  -Q[uiet]       enter quiet mode
  -V[tp]:name    name=vtp server
  -S[end]:name   name=auto-send file name
  -R[emark]:text text=status line remark (20 chars maximum)

Command-Line Options

Use command line options when invoking T to specify the screen size and the COM port to be used:

`-L[ines]X` Where `X` = {25, 43, 50}
`-C[om]N` Where `N` = {1, 2, 3}
`-?` To display these options

Terminal Setup

All terminal setup functions are listed here. Press F2 from the program's main screen to view the Terminal Setup menu.

The Terminal Setup Options are as follows:

Help (press F1)
Port setup (Press F2)
Terminal emulation (Press F3)
Keyboard macros (Press F4)
Bells & Whistles (Press F5)
Exit setup mode (Press Esc or F8)

You must press Esc to return to the main screen before continuing with any functions other than the above setup functions.

Setup Terminal Emulation

To set up terminal emulation, follow these steps:

1. Press F2 at the main screen. The Terminal Setup dialog will be displayed. 2. Press F3. The Terminal Emulation Setup dialog will be displayed.

 Terminal Emulation Setup
 Emulator status: None loaded.

 Help:                       F1
 Z19 emulator:               F2

 Exit emulator setup mode:   Esc, F8

Setup Bells & Whistles

To change bells and whistles, follow these steps:

1. Press F2 at the main screen. The Terminal Setup dialog will be displayed. 2. Press F5. The Bells & Whistles Setup dialog will be displayed. 3. Make your selections.

Bells and Whistles Setup

Filter NULL characters: Yes
Disable beeps:          No

                      Background:   Foreground:
Normal screen:        Black         White
Status line:          Blue          Bright White
Scroll screen:        Blue          Red
Scroll status line:   White         Blue
Help screen:          Blue          Bright White
Menu:                 Blue          Bright White
Menu highlight:       Cyan          Black

Next Value:

Setting Communications Parameters

To change communications parameters, follow these steps:

1. Press F2 at the main screen. The Terminal Setup dialog will be displayed. 2. Press F2. The Current COM2 Port Parameters dialog will be displayed.

 Current COM2 Port parameters:

 Baud Rate:                   9600
 Parity:                      NONE
 Data Bits:                      8
 Stop Bits:                      1
 Write Timeout (sec.):        1.00
 Read Timeout (sec.):         0.10
 Handshaking:             XON/XOFF

 Next Value: ->   Previous Value: <-
 Next Field: Dn   Previous Field: Up
 Don't Change:   Esc
 Accept Changes: Enter

3. Use the Up Arrow and Down Arrow cursor keys to scroll backward and forward through the parameter list, and the -> and <- keys to scroll through allowable values for each parameter. 4. Press Escape to exit this dialog without changing values, or press Enter to save these values and exit the dialog.

Note: The communications port may be changed from the command line by using the `-c` option. See Command-Line Options.

Sending Files

To send a file, follow these steps:

1. Press F3. The Send File Control dialog will be displayed.

 Send File Control

 Send file name:
 SEND.TXT

 Don't send file:               Esc
 Accept changes and send file:  Enter

2. Enter the filename in the Send File name field. 3. Press Enter to send the file and exit the dialog, or press Escape to exit this dialog without sending a file.

Pausing and Scrolling

To enter Scroll Mode and pause display of communications, follow these steps:

1. Press F4. A status line will appear at the bottom of the screen.

F1=Help  ESC=Active mode  Screen Top is 100%
through the buffer.  Scroll Mode

2. Press F1 to display the Scroll Mode commands.

 Screen Scroll Mode

 F1 or ALT-H       Help
 Dn                Down a line
 Up                Up a line
 PgUp              Up a page
 PgDn              Down a page
 ESC or Enter      Return to active mode

3. Select a scroll mode command.

Receiving Files

To receive a file, follow these steps:

1. Press F6. The Capture File Control dialog will be displayed.

 Capture File Control

 Capture file name:
 Capture.Txt
 
 Capture entire buffer: F3
 START Capture:         F5
 Delete file:           F9
 Don't Change:          Esc
 Accept Changes:        Enter

2. Select an item from the Capture File Control menu.