A - A P P E N D I X -

A P P E N D I X A

KIXTERM.INI

This appendix describes the initialization file, KIXTERM.INI, which contains definitions for color and the keyboard that are used by the ECI/EPI Client terminal emulator. The file contains three sections

Section in File	Contents
`[keys]`	Key mappings, described in Key Mappings
`[system_colors]`	Color mapping from RGB values to symbolic names, described in Defining the Normal and Light Colors for a Terminal
`[colors]`	Color mappings from symbolic names to 3270 values, described in Mapping Colors
`[general]`	All other initialization settings, described in Resetting a Keyboard.

In addition, the initialization file contains comments, the format of which is described in Identifying File Comments.

Identifying File Comments

Identify a comment by preceding the comment text with a semicolon, for example:

; ---------------------------

; 3270 color designation

; ---------------------------

Key Mappings

The [keys] section of the KIXTERM.INI file contains the key mappings.

Format

 3270 key = System Key [ + Modifier key ]

where:

3270 key

Defined by the terminal emulator as a key that performs a specific 3270 operation. All 3270 keys have a symbolic representation. See TABLE A-1.

System Key

Defined as a symbolic representation of a key on a PC keyboard that is supported by the terminal emulator. See TABLE A-2 for the definitions.

Modifier key

Allow 3270 keys to be represented by key combinations. For example, the following defines the reset key as Alt R

reset = R + Alt

See TABLE A-3 for the definitions.

The following table shows the 3270 keys.


Symbolic Name	3270 Operation
backspace	Deletes the character to the left of the cursor in unprotected fields and moves the cursor 1 position left.
backtab	Moves the cursor to the first character position in the current field, if it is unprotected and it is not in the first character position. Otherwise, the cursor is moved to the previous unprotected field.
clear	Clears the screen and moves the cursor to the home position. An AID is transmitted.
cursorleft	Moves the cursor 1 position to the left.
cursordown	Moves the cursor 1 line down.
cursorright	Moves the cursor 1 position to the right.
cursorup	Moves the cursor 1 line up.
delete	Deletes the character under the cursor.
enter	Transmits the enter AID.
eraseeof	Erases all characters from the current cursor position to the end of the field.
eraseinput	Erases all unprotected fields.
insert	Toggles the terminal between insert and overtype mode.
newline	Moves the cursor to the first unprotected field on a line.
pa1 through pa3	Transmits the appropriate PA key AID.
pf1 through pf24	Transmits the appropriate PF key AID.
printscreen	Prints the current display on the local printer.
reset	Resets the keyboard lock.
tab	Moves the cursor to the first character position of the next unprotected field.

The following table shows the system keys.


Symbolic Name	System Key
A through Z	Keys A through Z
0 through 9	Keys 0 through 9
backspace	Backspace key
delete	Delete key
down	Down arrow
end	End key
escape	Esc key
f1 through f24	Function keys
home	Home key
insert	Insert key
left	Left arrow
rightctrl	Right control key
newline	Newline (enter) key
numpad0 through numpad9	Keys 0 through 9 on the numeric keypad
numpad+	+ key on the numeric keypad
numpad-	- key on the numeric keypad
numpad*	* key on the numeric keypad
numpad/	/ key on the numeric keypad
numpad.	. key on the numeric keypad
pagedown	Page down key
pageup	Page up key
pause	Pause key
printscreen	Print screen key
right	Right arrow
scroll_lock	Scroll lock key
tab	Tab key
up	Up arrow

The following table shows the modifier keys.


Symbolic name	System Key
Shift	Shift key
Control	Left Control key
Ctrl	Left Control key
Alt	Right Alt Key

Defining the Normal and Light Colors for a Terminal

The system_color mapping allows the definition of the normal and light forms of color used by the terminal. TABLE A-4 lists the system colors.

Format

system_color = RGB(red, green, blue)

where red, green, and blue are numbers between 0 and 255 that represent the amount of color used in the resulting system color. For example:

light_white = RGB(255,255,255)

Mapping Colors

Color mapping allows you to map from symbolic names to 3270 values. The color mapping takes two forms, which define the color representation used by the emulator

When displaying 3270 fields that contain color attributes. For example:

3270 color = System color

When displaying fields that do not contain any color attributes. In this form, the color of a field is determined by the field attribute. For example, the following statement causes all normal unprotected fields to appear as light green, by default:

normal_unprotected = light_green

The following table defines the symbolic representation of 3270 colors, system colors, and field attributes:


3270 Colors	System Colors	Field Attributes
Default	red / light_red	`normal_unprotected`
red	green / light_green	`normal_protected`
green	blue / light_blue	`intensified_unprotected`
blue	pink / light_pink	`intensified_protected`
pink	cyan / light_cyan
turquoise	yellow / light_yellow
yellow	white / light_white
white	black

Resetting a Keyboard

The general section contains initialization options that do not relate to key or color mapping. In this release of the emulator, only one entry is valid:

kbd_reset = end_of_transaction

The kbd_reset option causes a keyboard reset to occur every time a transaction ends. The option is incorporated into the emulator because it makes the terminal easier to use. This action is not part of the standard 3270 architecture and, if it is not required, you can remove it from the KIXTERM.INI file by commenting it out with a semi-colon:

; kdb_reset = end_of_transaction

If you comment it out, you may have to reset the keyboard if a transaction locks the keyboard.