KernelDebugRef - The T Terminal Emulator
Reprint Courtesy of International Business Machines Corporation, © International Business Machines Corporation
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.