Previous Page Contents Page Next Page

Appendix A: Required and Recommended Functions in the terminfo Database

To allow Solaris terminals to use the screen interface of the TN3270 program, define the following required or recommended functions in the terminfo database. To alter the terminfo database, use the tic and infocmp programs provided with your Solaris operating system. Refer to the Programmer's Reference for your operating system for more information about terminfo database, and the tic and infocmp programs. The termcap names are shown in the terminfo entries that refer to them.terminfo requirements>

Required functions

Terminals without the following functions cannot be used with the TN3270 program, unless the TN3270 program is running in the background. They can, however, be used for other SNAP-IX TN3270 functions such as running HLLAPI application programs or creating configuration files.

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 TN3270 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 TN3270 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 listbox. 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 listbox. 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 TN3270 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 TN3270 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 SNAP-IX TN3270 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 TN3270 programs that support color.

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

The TN3270 display screen can be run without attribute support, but if your terminal provides attribute support, attribute support displays underline, reverse 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 TN3270 sessions to write the 3270 status line to the terminal's status line. If this feature is not available, the TN3270 emulation program uses the last line of the screen to display the status line. Depending on the TN3270 screen model and the terminal's screen size, this may mean that the last line of the screen is shared between the TN3270 display and the status line.

The TN3270 program'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. Refer to the SNAP-IX TN3270 User's Guide for more information.

Include in the terminfo database any additional keys on the terminal's keyboard if you want to use them in the TN3270 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