keysh(1)

keysh(1)

USING KEYSH WITH TERMINAL SESSION MANAGER

 

When operating under the Terminal Session Manager (see tsm(1)), keysh displays the

tsm softkeys

instead of the backup softkeys. If desired, this interaction can be overridden by setting the $KEYTSM environment variable (see ENVIRONMENT VARIABLES below).

When operating under tsm, keysh also automatically displays the tsm window number in the status- line.

CONFIGURATION

All keysh con®guration functions are accessed through the top-level Keysh_config softkey command or kc built-in command. These functions include:

∙adding, placing, and deleting softkeys,

∙specifying backup softkeys,

∙selecting global options,

∙selecting status-line items,

∙restarting keysh,

∙writing con®guration changes, and

∙undoing other con®guration changes.

Each time the user changes keysh's con®guration, keysh automatically updates the user's $HOME/.keyshrc ®le. Upon subsequent invocations, keysh automatically recon®gures itself as con®gured previously.

Adding, Placing, And Deleting Softkeys

Any of the standard softkeys (see STANDARD SOFTKEY DEFINITIONS below) can be added to the top-level softkey menu using the kc softkey add command. If desired, an alternate softkey label may be speci®ed (usually in place of a cryptic HP-UXcommand name) using the with_label option.

By default, added softkeys are placed at the end of the last --More--bank of the top-level softkey menu. This placement can be overridden using the and_place option of the kc softkey add command or using the kc softkey move command.

In addition to the standard softkeys, custom softkeys can also be added from custom softkey ®les using the from_user or from_file options. For a description of the softkey ®le format, see softkeys(4).

Note that any time a softkey is added from a particular softkey ®le, all of the remaining softkeys from that ®le are automatically loaded for use as invisible softkey commands. All softkeys from a ®le can also be loaded for use as invisible softkey commands using the kc softkey add invisibles command.

Any of the softkeys in the top-level softkey menu can be deleted using the kc softkey delete com- mand.

Specifying Backup Softkeys

Backup softkeys are typically speci®ed in the user's $HOME/.softkeys ®le. The basic backup softkey de®nition line resembles:

backup softkey "<softkey>" literal "<string>";

Where <softkey> is the softkey label to display and <string> is the text string to program the terminal function key with. A maximum of eight backup softkeys can be speci®ed.

Note that backup softkeys must be explicitly added using the kc softkey add backups command before keysh can program them.

Selecting Global Options

Various global options can be con®gured using the kc option command, including:

backups Enable or disable the programming of the backup softkeys.

help

Enable or disable the --Help--softkey.

invisibles Enable or disable the recognition of invisible softkey commands.

prompts Enable or disable the automatic generation of prompt messages. When enabled, keysh displays a prompt message whenever the user must perform an action to complete the current softkey command. This message brie¯y describes the required action.

HP-UX Release 11i: December 2000

− 3 −

Section 1−385

k