Configuring CICS for Fileshare

Configuring CICS for Databases

Chapter 7: Configuring CICS Terminals

This chapter describes how to remap the terminal keyboard and terminal colors for the CICS Option component of Mainframe Express.

7.1 Keyboard Remapping

You can remap the 3270 keys to mappable keys on the PC keyboard enabling you to choose which key on the PC keyboard will represent a 3270 key. This means you can define a keyboard layout that is familiar to you, rather than having to learn an unfamiliar one.

You control this remapping with the configuration file, dfh3270.cfg.

For keyboard remapping, the configuration file contains a header record:

[KEYBOARD]

which must start in column 1, followed by a record for each key that is to be remapped. The format of each record is:

PC-physical-key-name : 3270-key-name

where:

For example, to map the Clear 3270 key onto the Ctrl+Return key on the PC keyboard, you would specify the record:

CTRL-RETURN      : CLEAR

and to define the numeric keypad plus (+) key on the PC keyboard as an extra tab key, you would specify the record:

NUMPAD-+         : TAB 

Mainframe Express looks for the configuration file dfh3270.cfg in folders mfuser\config and \mfe\config (in that order). If no configuration file is found, the default key mappings are used.

A sample dfh3270.cfg file is supplied in \mfe\mfcics\source that contains one entry mapping the Enter 3270 key to the right-hand Ctrl key on the PC keyboard.

7.1.1 3270 Key Names Table

All displayable character keys have the same name as the character, and are entered in a configuration file record as such. By default, each displayable character key maps to itself. To remap these keys, enter the physical key name you require (from the Physical Keys table) in the first column of the configuration file record followed by the character (the keyname) in column 19. For example:

Z                : a

maps the lowercase "a" 3270 key to the uppercase "z" (Z) key on the PC keyboard.

The following table shows the names of the non-displayable 3270 keys as they should be entered in the configuration file together with the default PC keyboard setting for each 3270 key.

Note: On some keyboards, the right Ctrl key does not emulate the function of the 3270 Enter key. If the system does not respond when you press the right Ctrl key, depress the left Ctrl key and the Return key instead.

7.1.2 Physical Keys Table

7.1.3 Numeric Keypad Keys (NumLock On) Table

The following table shows, which keys on the PC numeric keypad can be set to represent 3270 keys when the numeric lock is set on. A "Y" indicates that the physical key can be remapped to a 3270 key.

7.1.4 Numeric Keypad Keys (NumLock Off) Table

The following table shows which keys on the PC numeric keypad can represent 3270 keys when the numeric lock is set off. "Y" indicates that the physical key can be remapped to a 3270 key.

7.2 Color Remapping

You can remap the standard 3270 screen colors to colors on the PC screen. You control this remapping with the configuration file, dfh3270.cfg.

For color remapping, the configuration file contains a header record:

[COLOR]

which must start in column 1, followed by a record for each color that is to be remapped. The format of each record is:

physical-color      : 3270-color

where:

For example, to map the 3270 color blue onto the PC screen color light blue, you would specify the record:

LIGHT-BLUE       : BLUE

in the configuration file.

7.2.1 Colors Table

The following table shows the 3270 color names with the PC physical screen colors that they map to by default.

Configuring CICS for Fileshare

Configuring CICS for Databases