# define-up command

The define-up BASIC program provides
a front-end for defining a keyboard for the Update processor. It builds
a keyboard item that is used by the set-imap program
to translate the keyboard keys entered into Update processor commands.
It automatically detects whether the keyboard needs the extended character
set enabled. After filing the item in the define-up program, then
execute a set-imap terminal-name (c command to put the new translations
into effect.

## Syntax

```
define-up {terminal.name} {(options}
```

## Parameter(s)

| terminal.name | Name of the terminal. | |
| --- | --- | --- |
| options | q | Quick update of the keyboard. Requests definitions of only the most commonly used commands. |
Warning: In order to have the translations active
at logon, a set-imap *terminal-name* should be executed from the user macro.

## Example(s)

Defines or allows modifications
to the keyboard item called `marks.terminal`.

```
define-up marks.terminal (q
```

## See also

- [esc-toggle command](https://d3codex.com/tcl/esc-toggle-command/)
- [keyboards file](https://d3codex.com/systemfiles/keyboards-file/)
- [set-imap command](https://d3codex.com/tcl/set-imap-command/)
- [xcs-off macro](https://d3codex.com/tcl/xcs-off-macro/)

---
Source: https://d3codex.com/tcl/define-up-command/ - part of the D3Codex reference.