Chapter 4: Keyboard Configuration Utility (Keybcf)

The Keyboard Configuration Utility, Keybcf, enables you to change the functions assigned to the keys on your keyboard. You can change the action performed by keys during execution of an ACCEPT statement, and the function keys used by your own programs.

Normally, the default keys built into Adis should not need changing. However, you may need to change the keys used to emulate a particular dialect of COBOL.

The default set of keys used by your COBOL system is built into Adis. Keybcf creates a file called cobkeymp which contains the keystrokes that are to be used for function keys and the keys Adis uses during an ACCEPT operation.

4.1 Invoking Keybcf

Either enter at the command line:
```
keybcf
```
to set up your own cobkeymp file.

or

If you have created a group for COBOL, double-click the appropriate program icon to invoke the component.

Keybcf searches for a file called cobkeymp in the current directory and then the directories specified by the COBDIR environment variable. If the file is found, you are asked if you want to edit it. Answer "Y" if you want to edit the file or "N" if you want to create a new file based on the default set of keys. If the file is not found, one is created.
From the initial menu, press the number (1-4) for the option you want.

4.2 Reviewing Existing Function Key Definitions (Option 1)

Enter 1 from the main Keybcf menu.
This menu enables you to list all currently defined function keys in one of three sets: Adis, user, or compatibility.
Press the number for the list you want to output.
Option 5 is a toggle to determine whether a selected list is shown on the screen or written to a file. If you select the screen as the destination, all the currently defined function keys in that list are displayed with their hexadecimal values. To page from one screen to the next, press any key. When you reach the end of the list, press any key to return to the Review Existing Function Key Definitions menu.
If you select to output the list to file, the same information is written to a file called keylist.dmp. This happens without further intervention unless the file keylist.dmp already exists, in which case you are asked whether to overwrite it or append this list to the end. Press "O" to overwrite, "E" to extend.
Press 6 to return to the main Keybcf menu.

4.3 Modifying Function Key Definitions (Option 2)

Enter 2 from the main Keybcf menu.
Choose the set of function keys you wish to alter. You can select the Adis, user or compatibility function key lists.
Each function in the function key list you select is displayed individually.
Press the key you want to perform the new function, or use X to enter the hexadecimal code for the key. Once you have entered the new key, the program automatically cycles to the next function after a slight pause.
If you attempt to define a large number of keys you may exceed the limit, in which case you receive the warning:

There is not enough room for that sequence

If this occurs, the only way to add new keys is to delete unwanted key sequences.
Press 5 to return to the main Keybcf menu.

See the section Adis Function Key List Menu in the chapter Enhanced ACCEPT/ DISPLAY Syntax for a list of available keys.

4.4 Saving Function Key Definitions (Option 3)

Press 3 from the main Keybcf menu.

This saves the changed function lists to a file calledcobkeymp.

4.5 Exiting from Keybcf (Option 4)

Press 4 from the main Keybcf menu to return to the operating system command line.

4.6 Run Time Search Mechanism

The diagram below shows the search mechanism that is used at run time to determine which keyboard configuration options Adis is to use.

4.7 The Key Lists

The following lists of keys can be reviewed and altered by Keybcf:

Adis function key list.
This list defines the keys which carry out specified functions when you are executing an ACCEPT statement in a COBOL program. See the section Adis Function Key List Menu in the chapter Enhanced ACCEPT/DISPLAY Syntax for a description of these keys.
User function key list.
The user function key list defines the keys that are normally returned to your program when a function key is pressed. See the section Defining a Key in Both the User and Adis Key Lists in the chapter Enhanced ACCEPT/DISPLAY Syntax if you want to define the same key in the Adis and User function key lists.
Compatibility function key list.
- This list defines an alternative user key list that can be used if you want to set up keys to be compatible with another dialect of COBOL. If the values returned by such keys differ from the standard user key list, you are advised to alter the compatibility function key list rather than the user function key list. By default, the compatibility function key list is configured for compatibility with RM/COBOL V2.0 on UNIX.
- The ACCEPT/DISPLAY option 22 in Adiscf enables you to choose between using the user or compatibility key lists.

By default, the user function keys are initially disabled. In order to use these function keys during the execution of a program, you must first enable them by calling the x"AF" library routine or by altering the configuration using Adiscf.

The Language Reference topic CRT STATUS clause allows you to ascertain which function key was used to terminate an ACCEPT operation.

4.7.1 Adis Function Key List Menu

The following keys are available on the Adis Function Key List menu:

Key	Description
Space	Cycles from one function to the next, without altering the key defined for each function.
Insert	Adds another key to perform the displayed function, but retains the currently defined function key. The word Insert is displayed at the bottom right of the screen.
Delete	Deletes a defined function key from a list. Keybcf automatically cycles to the next function.
HeX	Specifies that you will enter the hexadecimal sequence for the required function key. The word Hex is displayed at the bottom right of the screen. If you enter an invalid hexadecimal sequence you receive an error when you attempt to cycle to the next function and you are prompted to enter a valid sequence. This function allows you to define keys which may not actually appear on the keyboard you are using, but will be available on the one on which your program will run.
Quit	Returns to the Alter menu.

Configuring Adis Using Adiscf

Panels