HCON Utility Program Keys and Fields

3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference

HCON Utility Program Keys and Fields

The utility program uses several types of keys and fields to perform its functions.

Utility Program Keys

The utility program uses these types of keys:

Function Keys

Functions are listed at the bottom of every menu and are started by pressing the appropriate function key. Functions differ on every menu. This table lists these functions.

Function Keys for the Utility Program
Key	Function	Definition
F1	Help	Displays a pop-up window containing help information about the field the cursor is in.
F2	Refresh	Refreshes the screen.
F3	Exit	Exits the program without saving any updated color or keyboard table information.
F4	Change	Allows users to override the default values in the session profile for the logon/logoff portion of the utility program. This key is only available on the logon/logoff screens.
F5	File	Saves the current color and keyboard definitions (on the color or keyboard redefinition menu) into the designated output files. If the utility was started with the hconutil command, the color and keyboard definitions are saved either in the files specified by the -C and -K flags or in the $HOME/e789_ctbl and $HOME/e789_ktbl files, respectively. If the utility was started from within the emulator using the HCONUTIL key, the information is saved in the color and keyboard tables specified in the session profile for the session from which the utility was entered.
F7	Up	Scrolls the screen up one page. If the screen is at the first page, it wraps to the last page.
F8	Down	Scrolls the screen down one page. If the screen is at the last page, it wraps to the first page.
F10	Actions	Selects the key (on the keyboard redefinition menu) that the user wants remapped and moves the cursor up to the button bar at the top of the menu. If the cursor is on the button bar, pressing F10 takes the cursor back to the line item. The F10 key is available only on the keyboard redefinition menus.
F12	Return	Returns to the previous menu from any submenu, or closes the current pop-up or pull-down window.

Note: On a DEC VT100 keyboard, the F4 through F12 function keys are each represented by an escape sequence:

Function Key	Key Sequence
F4	Esc-4
F5	Esc-5
F7	Esc-7
F8	Esc-8
F10	Esc-0
F12	Esc-2

Up Arrow and Down Arrow Keys

The Up Arrow and Down Arrow keys move the cursor up and down through the different fields on the screens. If the cursor is at the last field on the bottom of the screen, the Down Arrow key moves the cursor to the first field at the top of the current column. If the cursor is at the top field, the Up Arrow key moves the cursor to the last field of the current column.

Note: In the keyboard redefinition pull-down menus, the arrow keys do not wrap on the screen. Instead they scroll through the values for that particular pull-down menu.

Tab Keys

The Tab and Backtab keys move the cursor right and left, respectively, through the fields on the current line. If the cursor is at the end of a line, it wraps around the screen. For example, if the cursor is at the last field on the left, the Tab key moves the cursor to the first field on the right of the current line.

Left Arrow and Right Arrow Keys

The Left Arrow and Right Arrow keys toggle through the values of the fields. The Right Arrow key toggles forward through the list of values while the Left Arrow key toggles backwards through the list of values. The values wrap if the end or the beginning of the list is encountered. For example, when the Left Arrow key is pressed and the current value is the last one listed, then the first value is displayed. The Left and Right Arrow keys are valid only on the color redefinition submenus and the file transfer submenus.

The Left and Right Arrow keys also scroll text to the left and right in edit fields containing long file name strings with limited visual display.

Enter Key

Depending on the screen in use, the Enter key has the following function:

From any menu screen, press the Enter key to select which submenu to display next.
From the keyboard redefinition button bar, move the cursor to the desired button bar field using the Tab and Backtab keys. Press the Enter key to display the pull-down window for that button bar option.
Within the keyboard redefinition button bar pull-down window, press the Enter key to select the value to be mapped to the selected key.
For file transfer, press the Enter key to issue a file transfer request when all of the information has been specified on the file transfer panels.
In the Logon/Logoff screens, press the Enter key to initiate the logon/logoff process after all of the information has been entered. From the change values windows in the logon/logoff screens, press the Enter key to enable the entered data to override the session profile data.
From the Read File/Save File pop-up windows, press the Enter key to select the name of the file to be read or saved.

Utility Program Fields

The utility program displays data in several types of fields. It also uses a message field and a heading field to display information about the screens and menus.

Data Fields

The utility program uses three types of fields to display user data choices:

`edit`	Requires the user to input data.
`toggle`	Has limited choices and allows the user to toggle through those choices.
`display`	Indicates the current value of the field. A display field can usually be changed by a selection process or from another menu.

The hconutil command supports edit fields containing file name strings of up to 1024 characters with limited visual display. The strings display as:

[text]	The entire string displays.
[text>	There is more text to the right. Use the Right Arrow key to scroll the text to the right.
<text]	There is more text to the left. Use the Left Arrow key to scroll the text to the left.
<text>	There is more text to the right and left. Use the Right and Left Arrow keys to scroll the text.

Message Field

The message field is a one-line field at the bottom of the screen. The field displays messages such as warnings and work completed, including:

`You have pressed a key that is not valid.`
	Disappears when either a valid key or the Refresh key is pressed or when a different menu is displayed.
`WARNING: Foreground and background colors are the same.`
	Displays on the color redefinition menu when the foreground and the background colors for a certain line are set to the same value. The message goes away when the foreground or background color is changed, the cursor is moved to a different line, or to a different menu.
`The color definition table is saved successfully.`
	Displays when the program successfully saves the color definition table. To save the color definition table, press the F5 key while in the color redefinition submenus.
`The keyboard definition table is saved successfully.`
	Displays when the program successfully saves the keyboard definition table. To save the keyboard definition table, press the F5 key while in the keyboard redefinition submenus.
`Log attempt to session 'a' is in progress.`
	Displays for each logon and logoff attempt. Indicates which log attempt is currently running.
`All log attempts completed. Please check status.`
	Displays after all requested log attempts have completed.
`Explicit File Transfer request being attempted.`
	Displays after the Enter key is pressed on the file transfer screens.
`The color definition table was not read in successfully.`
	Displays during access to the color submenus if the color table was not read in successfully. Enter a color table file name into the read file name window.
`The keyboard table was not read in successfully.`
	Displays when accessing the keyboard submenus if the keyboard table was not read in successfully. Enter a color table file name into the read file name window.

Heading Field

The heading field is a one-line field below the submenu title providing column headings for the information on the screen or instructions such as:

Move the cursor to the entry you want and press <enter>.

The Heading and Message Fields figure shows the HCON utility program Main Menu with a heading and message field in bold face type.

[ Previous | Next | Contents | Search ]