H-19 Terminal Keyboard Map and User Guide

Main Keyboard Map

H-19 Key	Mac Key Extended Kb	Mac Key Normal Kb *
F1	F1	option 1
F2	F2	option 2
F3	F3	option 3
F4	F4	option 4
F5	F5	option 5
Blue	F6	option 6
Red	F7	option 7
Gray	F8	option 8
Scroll	F9	option 9
shift-Scroll	shift-F9	shift-option 9
shift-Scroll	page down	n/a
Break	F12	option =
Erase	clear	clear
shift-Erase	shift-clear	shift-clear
Return	Return	Return
Enter	Enter	Enter

* - To get the function and color keys on a non-extended keyboard, use the option key along with the digits on the top row of the main keyboard. Break is option and the '=' key at the top of the main keyboard.

Note: Pressing command-clear will erase the screen locally, without sending any character or character sequence to the H8.

go to top

Keypad Map

H-19 Keypad	Mac Keypad	Additional Mac Key	H-19 Terminal Function
shift 1	shift 1	n/a	insert line
shift 2	shift 2	down arrow	cursor down
shift 3	shift 3	n/a	delete line
shift 4	shift 4	left arrow	cursor left
shift 5	shift 5	home	cursor home
shift 6	shift 6	right arrow	cursor right
shift 7	shift 7	n/a	enter/exit insert character mode
shift 8	shift 8	up arrow	cursor up
shift 9	shift 9	forward del	delete character

Note on the Macintosh arrow keys:

When the H-19 keypad is in "normal" mode, the Mac's arrow keys will always be cursor-motion keys, regardless of the shifted state or the state of the shift keys. However, when the H-19 keypad is in "alternate" mode, the arrow keys will produce the same sequences as the 2, 4, 6 and 8 keys on the keypad, again regardless of the shifted state or the state of the shift keys.

The 'del' and 'home' keys on the Mac keyboard do the same thing: they'll produce either alternate or shifted sequences, but never digits.

If this seems confusing, the Extra Mac Keys section of the H-19 Programming Information page should help.

go to top

There are two function key sequences that are strictly local to the emulator; that is, they don't cause anything to be transmitted to the H8.

command-clear

This will cause the screen to be cleared and the cursor to move to the home position. If this is issued when the cursor is on line 25, only line 25 is cleared and the cursor will move to line 25, column 1.

command-option-clear

If confirmed by the user, this will clear the screen (see command-clear above) and the terminal scroll-back buffer. Line 25 is not cleared.

command-F9 or command-option-9

This will "toggle" Hold Screen Mode.

go to top

This is a quote from Heathkit's H-19 Video Terminal User Manual: "The Hold Screen Mode allows you to control when new information is printed on the screen. This is especially useful when you are reading lists or looking for a particular part of a program. [Place the terminal into Hold Screen Mode.] Then ... each time you type the SCROLL key a new line of text will appear on the bottom line and the top line of text will scroll up and off the screen. If you type SHIFT SCROLL, a whole new page (24 lines) of text will be scrolled onto the screen. ... Remember: in this mode, when the cursor is at the start of a line of text [on line 24], the terminal is probably waiting for a scroll command."

Working with Hold Screen Mode

Use these keys or key sequences to operate Hold Screen Mode.

command-F9, command-option-9

Toggle Hold Screen Mode on and off. These keys have only a local effect on the H-19 terminal; they do not cause anything to be transmitted to the H8.

There is an on-screen indicator that lets you know whether Hold Screen Mode is presently enabled or disabled.

If you use these keys while holding on line 24, Hold Screen Mode will be disabled and output will resume scrolling normally.

F9, option-9

When holding at the bottom of the screen, this will cause the screen to scroll up one line, and one new line will be displayed on line 24. These keys have only a local effect on the H-19 terminal; they do not cause anything to be transmitted to the H8.

If you are not in Hold Screen Mode or are not holding on line 24, these keys have no effect.

shift-F9, shift-option-9, page down

When holding at the bottom of the screen, this will cause the screen to scroll up 24 lines. These keys have only a local effect on the H-19 terminal; they do not cause anything to be transmitted to the H8.

If you are not in Hold Screen Mode or are not holding on line 24, these keys have no effect.

There is an on-screen indicator that is displayed when the H-19 is holding on line 24.

go to top

To help you keep track of what mode you are in, there are three on-screen mode indicators that may appear on the bottom-right corner of the H-19 Terminal window:



When you see this "fist" icon, the H-19 Terminal is in hold mode but is not holding; that is, it's not waiting for you to press the scroll key to display more information on the screen.

Hold mode can be toggled by pressing command-F9, and can be turned on and off by a program that issues the appropriate escape sequences.



When you see this "hand" icon, the H-19 Terminal is holding on line 24 waiting for you to press Scroll or Shift-Scroll before displaying more information.

The open palm of the hand is, in essence, saying "Halt!"



When you see this "insert" icon, the H-19 Terminal is in Insert Character mode; characters typed or output to the screen will be inserted at the cursor location. When this indicator is not visible, the H-19 Terminal is in overtype mode; characters typed or output to the screen will write over the character at the cursor location.

Shift-keypad 7 sends sequences to the H8 to toggle Insert Character Mode on and off. But the program you are running can turn this mode on and off without keyboard entry.

go to top

The H-19 has a 500-line screen buffer. This is divided into two pieces: a 476-line scroll-back buffer on top, and a 24-line active H-19 screen at the bottom. Screen line 25 is not a part of this buffer.

The 24-line screen is the space where H-19 emulation takes place. Operations such as erase and insert/delete take place in this space.

Material moves to the scroll back buffer only by scrolling off the top of the active H-19 screen. Important: If the screen is cleared, the information on the screen is lost; it will not be in the scroll-back buffer. This behavior will occasionally result in odd gaps in the scroll-back buffer. For example, if you start the Pie editor with the bottom part of a CATalog listing on the screen, only the part that has scrolled off the screen will be in the buffer; the part that was on the H-19 screen will be lost when the screen is cleared. And no part of the Pie editing session will be saved, as nothing scrolls off the top of the screen when you use the Pie editor.

Once material enters the scroll-back buffer, it stays there until it is scrolled off the top of the buffer or until the emulator is quit.

You can scroll through the scroll-back buffer, and you can save the contents of the buffer to the Macintosh disk.

Scrolling through the buffer

You can scroll through the buffer using the scroll bar or keyboard keys. When you scroll back into the buffer, the cursor is removed from the active screen and you enter scroll-back mode. Scroll-back mode ends when the H8 writes to the H-19 screen, so make sure that the H8 is not writing to the screen, or use Hold Screen mode or type Ctl-S before scrolling back into the buffer.

To end scroll-back mode, simply start using the H8; the first character of output will cause the screen to normalize.

Use the scroll bar as you would with any Mac application. The up/down arrows will repeat, after a brief delay, at the rate of 33 lines per second. Page up/down will repeat, after a brief delay, at the rate of five 23-line pages per second. The H8 will continue to run when you use the up/down arrow and up/down page areas to scroll. If you scroll by dragging the slider, the H8 will pause operation until you release the mouse button.

You can use the following keyboard keys to scroll through the buffer. The command key must be held down for these keys to function as scroll-back keys.

Key-scrolling repeats at your Mac's key repeat rate.

Scroll Keys

Mac Key	Scroll-Back Function
command-up arrow	scroll up one line
command-down arrow	scroll down one line
Mac extended keyboard keys
command-page up	Scroll up one page (23 lines).
command-page down	Scroll down one page (23 lines)
command-home	Scroll to the first non-blank line in the buffer. If the first non-blank line is on the active screen, the screen does not scroll and the H-19 does not enter scroll-back mode.
command-end	Scroll to the end of the buffer so that the active H-19 screen fills the window

Saving the buffer

When the H-19 window is front, the File menu item "Save H-19 buffer..." is active. Select this item to save the contents of the scroll-back buffer and H-19 screen to a Mac text file.

Save starts from the first non-blank line in the scroll-back buffer and proceeds through line 25, if enabled, of the active H-19 screen. There will be a maximum of 502 lines in the resulting file (there is a carriage return at the end of the last line), but could be fewer if there are blank lines at the top of the scroll-back buffer or line 25 is not enabled. If nothing has yet been written to the H-19, the saved file will be empty.

Trailing spaces are removed from each line. There is no other processing of the data. H-19 graphics are saved with the high-order bit set; graphics are properly displayed if you view the file using the Heath font at 10 points. Reverse video mode is not preserved in the output, but the characters are saved.

go to top

There are three ways to select text to copy to the clipboard:

1. Use the Select All item on the edit menu. All text, starting at the first non-blank line in the scroll-back buffer through line 24 of the active screen, will be selected for copy.

2. Scroll, if necessary, to either end of the desired selection. Click once to set an anchor point. A caret will be inserted into the text.

   Now scroll, if necessary, to the other end of the selection range and shift-click to select the text between the two points.

   You can continue to shift-click to extend, shorten, or change the selected range of text. The first anchor stays where it is; you are moving the second point.

   To abandon the selection, click somewhere without holding down the shift key to set a new anchor point. Or simply start using the H8; H8 output will remove the caret and deselect the text.

3. Click at one end of the selection range. Holding the mouse button down, drag to the other end of the range. If you move the mouse above or below the borders of the H-19 window, the window will scroll automatically.

   There are two speed zones: if you are within 10 pixels of the top or bottom of the window, it will scroll slowly; if you drag further outside the window, scroll speed will increase.

   To change the range, simply repeat the operation elsewhere in the buffer. Or use shift-click (see #2 above) to change the range (the starting point of the shift-drag is the first anchor point). Or simply start using the H8.

With text selected, you can use the Copy item on the edit menu to copy the text to the clipboard.

Important Note - Any output from the H8 will cause the screen to normalize. In addition to rehoming the screen if it is scrolled, the caret will be removed and any selected text will be deselected. If you need to select for a copy while a program is running that might write to the H-19, type Ctl-S before selecting text.

go to top