Edit Keymap

Standard

Modify Standard Keymap. This option allows for the modification of the Standard Edit and Function Keys. These keys are divided into three columns and are acted on and modified as a group.

After selecting the column to be modified, the user is placed on the current key assignment. To change a key value, press the <Change> key (default F5), which prompts the user for the new key value. To assign a new key value, press the function or control key to be used, or press <RETURN> to leave the value unchanged. When finished editing the column values, press the <Accept> key (default F4) to update the changes, or the <Abandon> key (default F2) to cancel the changes.

Application

Modify Application-Defined Function Keys. This option allows the developer to define up to eight keys for application-specific functions. These keys return either a CTLVAL to the application or cause the input utility to call a program.

To add an Application-defined key:

1. Enter the LABEL that may be disabled and press <RETURN>. This takes the cursor to the Keystroke column.

2. To change a key value, press the <Change> key (default F5), which prompts the user for the new key value. To assign a new key value, press the function or control key to be used, or press <RETURN> to leave the value unchanged.

3. If an application CALL program is to be executed with this keystroke, enter the program name in the Action column. Note: It is possible, and desirable, to utilize indirect labeling to ensure the correct program.

As an example, to execute the program /basis/myproj/inquiry (assuming that the global string (PROJECT) has been set to /basis/myproj/), enter the following: (PROJECT)inquiry.

When the user presses the appropriate function key, the input control utility resolves the global label and CALLs the program. When the program EXITs, the control utility returns to the input field.

If an ACTION program is not specified, the input control program returns the appropriate CTLVAL to the application program when that keystroke is entered.

After editing the Application function keys, press the <Accept> key (default F4) to update the changes, or the <Abandon> key (default F2) to cancel changes.

Write

Write keymap record. This option writes a record to the currently selected keymap file.

This option must be executed to save the currently defined keymap.

It has the following options:

Option	Description	Key
Default	Creates a DEFAULT keymap record.	"DEFAULT" + terminal_type + APPL$
User	Creates a keymap record for this user.	INFO(3,2) +terminal_type+ APPL$

The APPL$ variable can be passed to _ekeymap.utl to set an application specific as part of the key. If no APPL$ variable is passed, _ekeymap.utl checks for the global string (APPLICATION) in the string table. If it is not set, APPL$ defaults to TAOS+ the two-byte (LANGUAGE) global. APPl$ can be a maximum of 10 bytes.

When creating keymap files for distribution, remember that terminal type is derived from the device name given in the TSK() function, which returns device information from the config.bbx file. Configuring the keymap should be done in the environment in which it will be used. See the Installation Overview in the Installation and Configuration Guide for additional information on config.bbx and the Commands Manual for additional information on the TSK() function.

Restore

Restore keymap from the file. This cancels all current changes, restores the default keymap, and allows the user to start over.

Exit

Exit keymap utility. This exits the program; however, it does not create a permanent record of the key mappings. It has the following options:

Option	Description
Save	Exits the session and initializes the current workspace with this keymap. This does NOT write to the file. It only saves changes for the current session. Select the Write option first to write a record to the keymap file.
Quit	This exits the session without initializing the current workspace.