Progress
Client Deployment
Guide


Specifying Keyboard Mappings

The PROTERMCAP file maps key functions to key labels. Table 5–12 shows the mappings as installed. Many of the mappings shown are terminal specific, and certain terminals might not support the function for a particular sequence given in the table.

Table 5–12: Progress PROTERMCAP Key Functions

Key Function
UNIX
Key Label
ABORT
CTRL-\
CTRL-ALT-DEL
APPEND-LINE
CTRL-A
BACKSPACE
BACKSPACE
CTRL-H
DEL-CHAR
BACK-TAB
BACK-TAB
CTRL-U
SHIFT-TAB
BELL
BELL
CTRL-G
BLOCK
SELECT
CTRL-V
BOTTOM-COLUMN
ESC-CTRL-B
BREAK-LINE
ESC-B
CANCEL-PICK
ESC-CTRL-X
CHOICES
ESC-CTRL-H
CLEAR
F8
CTRL-Z
CLOSE
ESC-Z
COMPILE
ESC-P
COPY
F11
ESC-C
CURSOR-DOWN
CURSOR-DOWN
CTRL-J
CURSOR-LEFT
CURSOR-LEFT
CTRL-O
CURSOR-RIGHT
CURSOR-RIGHT
CTRL-L
CURSOR-UP
CURSOR-UP
CTRL-K
CUT
F10
ESC-X
DEFAULT-POP-UP
ESC-U
DELETE-CHARACTER
DEL
DELETE-COLUMN
ESC-CTRL-Z
DELETE-END-LINE
ESC-K
DELETE-FIELD
ESC-CTRL-D
DELETE-LINE
REMOVE
CTRL-D
DELETE-WORD
ESC-D
EDITOR-BACKTAB
CTRL-B
EDITOR-TAB
CTRL-G
END
END
ESC ->
ESC-.
END-ERROR
F4
PF4
ESC
CTRL-E
ENTER-MENUBAR
F3
PF3
ESC-M
EXIT
ESC-Q
FIND
CTRL-F
FIND
FIND-NEXT
ESC-F
FIND-PREVIOUS
ESC-I
GET
F5
ESC-O
GO
F1
PF1
CTRL-X
DO
GOTO
ESC-G
HELP
HELP
F2
ESC-?
PF2
HOME
HOME
ESC-H
ESC-h
ESC-<
ESC-,
INSERT-COLUMN
ESC-CTRL-N
INSERT-FIELD
ESC-CTRL-G
INSERT-FIELD-DATA
ESC-CTRL-F
INSERT-FIELD-LABEL
ESC-CTRL-E
INSERT-MODE
INS
F9
CTRL-T
CTRL-@
LEFT-END
ESC-LEFT-ARROW
MAIN-MENU
ESC-CTRL-M
MOVE
ESC-CTRL-V
NEW
ESC-N
NEW-LINE
INSERT-HERE
CTRL-N
NEXT-ERROR
ESC-E
NEXT-FRAME
ESC-CTRL-I
NEXT-WORD
CTRL-W
OPEN-LINE-ABOVE
ESC-L
OPTIONS
ESC-CTRL-O
PAGE-DOWN
PAGE-DOWN
ESC-CURSOR-DOWN
ESC-DOWN-ARROW
NEXT-PAGE
NEXT-SCRN
PAGE-LEFT
ESC-W
PAGE-RIGHT
ESC-Y
ESC-CTRL-J
PAGE-RIGHT-TEXT
ESC-CTRL-J
PAGE-UP
PAGE-UP
ESC-CURSOR-UP
ESC-UP-ARROW
PREV-PAGE
PREV-SCRN
PASTE
F12
ESC-V
PICK
ESC-CTRL-P
PICK-AREA
ESC-CTRL-W
PICK-BOTH
ESC-CTRL-Q
PREV-FRAME
ESC-CTRL-U
PREV-WORD
CTRL-P
PUT
F6
ESC-S
RECALL
F7
CTRL-R
REPLACE
ESC-R
REPORTS
ESC-CTRL-A
RESUME-DISPLAY
CTRL-Q
RETURN
RETURN
CTRL-M
RIGHT-END
ESC-CURSOR-RIGHT
ESC-RIGHT-ARROW
SAVE-AS
ESC-A
SCROLL-LEFT
ESC-CTRL-L
SCROLL-MODE
ESC-T
SCROLL-RIGHT
ESC-CTRL-R
SETTINGS
ESC-CTRL-@
STOP
CTRL-C
CTRL-BREAK
STOP-DISPLAY
CTRL-S
TAB
TAB
CTRL-I
TOP-COLUMN
ESC-CTRL-T

Using Key Function Syntax

To change any of these mappings or create new ones, use the following syntax:

keyfunction(key-label) = sequence: 

keyfunction

The name of a key function.

key-label

The key label as it appears on the keyboard.

sequence

The characters transmitted when the key is pressed.

As in other sections of the PROTERMCAP file, string values are assigned using an equal sign (=) and the field is terminated with a colon (:).

For example:

RECALL(F7)=^AF\r: 

This field in a PROTERMCAP terminal entry defines the F7 key as transmitting a CTRL-A followed by a capital F followed by a carriage return, and associates use of F7 with the RECALL function.

The following field defines SCROLL-DOWN to act like PAGE-DOWN:

PAGE-DOWN(SCROLL-DOWN)=\021: 

If you assign the same key label to two or more different key functions, you get a warning message when you start Progress. For example, “You cannot use DELETE for both DELETE-CHARACTER and BACKSPACE.”

If you use a key in the Progress ON statement or GO-ON option only, and do not have to assign it to a standard action, then use the following syntax in the PROTERMCAP entry:

(key-label)=sequence: 

For example, the following entry indicates that pressing F16 sends a capital O followed by a carriage return:

(F16)=O\r: 

If any of the control code sequences sent when you press a key on the keyboard begin with a control key, you cannot use that control key on your keyboard and the key does not have its normal Progress meaning. For example, if you specify CTRL-F in a control code sequence when creating a key mapping, you can no longer use CTRL-F for FIND. You have to map another key to the FIND action.

The key labels that the UNIX stty command specifies for FLUSH and SUSPEND override the PROTERMCAP file’s use of the same key labels. For example, if the stty settings for FLUSH and SUSPEND are CTRL-Q and CTRL-S, you cannot map these key labels to key functions in the PROTERMCAP file. If you do, you receive no warning; the labels assume their stty meanings at run time and Progress ignores them.

UNIX stty Control Functions

The installed PROTERMCAP file does not map the Progress functions ABORT, STOP, and UNIX-END to key labels. Progress instead uses the key labels that the UNIX stty command specifies for QUIT, INTR and EOF respectively.

For example, the following stty command specifies that Progress should use CTRL-\ for ABORT, CTRL-C for STOP, and CTRL-D for UNIX-END:

stty quit ^\ intr ^C eof ^D 

The labels specified by the stty command are of two forms: either CTRL-X or DEL if the DELETE key (octal 177, decimal 127) is used. When entering the stty command, indicate the control character by holding down the CTRL key and pressing the specified key; you do not type a caret (^) followed by the key.

If an entry in the PROTERMCAP file uses one of the key labels specified in the stty command, you get a warning message when you start Progress. For example, if the stty command specifies the DELETE key for the STOP function and the PROTERMCAP file specifies the DELETE key for the DELETE-CHARACTER function, you receive a warning message.

In UNIX environments that do not use the Bourne shell (for example, the Korn shell or C shell), job control allows you to end a job currently executing on a terminal. In most environments this is initiated using CTRL-Z; however, Progress uses this character sequence to clear the editor.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095