Previous Page Contents Page Next Page

Appendix A: Required and Recommended Functions in the terminfo Database

The user interface for the 3270 emulation program is compliant with IBM's Common User Access (CUA) guidelines.In order to use the emulator menu interface, Solaris terminal hardware uses certain functions, some of which are required and others of which are recommended. These functions must be correctly defined in the terminfo database entry used by that terminal.

To enable Solaris terminals to use the screen interface of the 3270 emulation program, define the following required or recommended functions in the terminfo database. The termcap names are shown in the terminfo entries that refer to them.

Required functions

Terminals without the following functions cannot be used with the 3270 emulation program, unless it is running in the background. They can, however, be used for other SNAP-IX programs such as the command-line administration program.

Screen size

The screen size defined in terminfo (the cols and rows entries) must be at least 80 columns by 24 rows.

Cursor addressability

Menus and dialog boxes cannot be drawn without this function.

F1 function key: kf1

This key is used to invoke the online help facility.

Up and Down arrow Keys: kcuu1 and kcud1

These keys are used to move within list boxes and to select buttons from radio groups.

Recommended functions

The following functions make the screen interface easier to use, but the interface can be used without them.

Alternate character mode: acsc, enacs, smacs, rmacs

Used to draw the menus and dialog boxes. If the Solaris terminal does not support drawing menus and dialog boxes, it can still use the menu interface, but the menus and dialog boxes will be drawn with characters such as - and + instead of solid lines.

The 3270 emulation program with the international option uses the ISO 8859 character set instead of the PC character set. In this case, whether you can display the box drawing characters depends on your version of Solaris and its curses library. You may be able to use them by modifying the acsc mapping, or you may have to remove the acsc mapping and use the - and + characters.

F2. . . F12 function keys: kf2 . . . kf12

Used in 3270 emulation to represent the 3270 keys PF2 to PF12. Some of these keys are also used as accelerators in the menu interface to provide a short-cut to certain dialogs or functions. If you do not have these keys, you can remap the 3270 keys to different keystrokes. The accelerator keys cannot be remapped, but it is possible to reach the same dialogs or functions by using the main screen menus.

Left and Right arrow keys: kcub1 and kcuf1

Used for moving within edit boxes and for selecting buttons from radio groups. If you do not have these keys, you can replace text in edit boxes instead of modifying it, and you can use the Up and Down arrow keys or accelerator keys to select buttons from radio groups.

PageUp: kpp or ka3 and PageDown : knp or kc3

Used to move quickly within a list box. The Up and Down arrow keys can be used instead, but are slower. Either of the termcap names can be used.

Home: ka1 or khome and End: kc1

Used to move quickly to the first or last entry in a list box. The Up and Down arrow keys or PageUp and PageDown can be used instead, but are slower.

Backtab: kcbt

Used for moving backwards through the sequence of items in a dialog box. If Backtab is not available, the keystroke Ctrl + B can be used instead. (These keystrokes are equivalent only in the menu interface.) In 3270 emulation, the default key mapping for the 3270 BACKTAB key is Backtab; remap this to Ctrl + B or any other suitable keystroke if you do not have the Backtab key.

Insert, Delete, and Backspace: kich1, kdch1, and kbs

Insert and Delete are used in the 3270 emulation program as defaults for the 3270 INSERT and DELETE keys. If Insert and Delete are not available, the 3270 keys can be remapped to different keystrokes. Delete and Backspace can be useful for modifying information in an edit box. (On some terminal types, such as the Wyse 60, Backspace is interpreted as a Left arrow key.)

Color support: colors, pairs, setb, setf

The 3270 emulation program menu interface can be run without color support, but it will use color if your terminal supports it. This applies particularly when communicating with host 3270 programs that support color.

Attribute support: blink, bold, dim, rev, smul, rmul, sgr0

The 3270 display screen can be run without attribute support, but if your terminal provides attribute support, it can display underline, reverse video, and blinking characters sent by the host.

Blinking characters do not display as blinking on Motif displays.

Access to terminal's status line: hs, fsl, tsl

If your terminal's hardware supports a status line to which user programs can write, you can customize 3270 sessions to write the 3270 status line to the terminal's status line. If this feature is not available, 3270 uses the last line of the screen to display the status line. Depending on the 3270 screen model and the terminal's screen size, this may mean that the last line of the screen is shared between the 3270 display and the status line.

If your terminal does not have suitably labeled keys, you can still use the 3270 emulation program by designating other keys to perform their functions.

The emulator's default keyboard mapping (the mapping between keystrokes on the Solaris terminal and the 3270 keys they represent) assumes that the Solaris terminal's keyboard has all the keys included in both the Required and Recommended lists. However, you can remap a 3270 key to a different keystroke if your Solaris terminal does not have the same key. For more information, see Customizing 3270 Emulation.

Include in the terminfo database any additional keys on the terminal's keyboard if you want to use them in the 3270 emulation program to represent 3270 keys. For example, if you have the function keys F13-F24, map the 3270 keys PF13-PF24 to these keys.

In some cases you may need to alter the terminfo database to include the functions shown. For example, if the keyboard has the PageUp and PageDown keys, but its terminfo entry does not include them, edit the terminfo entry to include them.

To use the Motif menu interface, the Solaris computer requires X11 Release 4 and Motif Version 1.1 , and an X display terminal. All of the required or recommended keys are generally available with this hardware and software.

The required and recommended keys in this section (such as function keys and cursor keys) are required or recommended for the Motif interface as well as the character-based interface. The other functions (such as screen size and alternate character mode) do not apply to the Motif interface.

Previous Page Contents Page Top of Page Next page