DEFCTL [WINDOW] eom$={ctl-val | *}

Use DEFCTL to define an additional CTL value to be returned for a given EOM (End-of-Message) value or to delete one. The EOM string is the sequence of characters received from the terminal to end the current input. The first character of the string must be a non-printable character between $00$ and $1F$, or $7F$; e.g.,

0010 DEFCTL $09$=6 ! Set TAB key to return CTL=6
0020 DEFCTL $1B38$=7 ! Set HOME <esc>H to CTL=7
0030 DEFCTL $09$=* ! Delete control value setting defined @line 0010

The normal setting for the TAB key is to return CTL = -1015.

0010 DEFCTL $09$ = -1015

Positive CTL values will be returned to the program. Negative CTL values have special significance to ProvideX. (Refer to the list of Negative CTL Definitions, at the end of this document and see Function & Control Keys in the ProvideX User's Guide.) See also, the CTL System Variable, and the EOM System Variable.

DEFCTL [WINDOW | WINDOW+] invalid_ctl= {alternate | *}

Use this format of the DEFCTL directive to define alternate CTL values to be applied whenever the specified CTL value is received and it would normally be rejected (e.g. A Page UP during a simple INPUT dircetive or Backspace when at the start of input).

For example, if you wanted to map the UP-ARROW (CTL=-1011) to return a CTL=3 whenever it was pressed and there was no valid location in the input to go to:

0020 DEFCTL -1011=3 ! Return CTL 3 on up arrow

Refer to the CTL( ) Function, and the CTL System Variable, for more information.

To create such a hot key, define the control sequence that is generated by the key as a negative CTL value in the range -10 through -999. Then create and save your hot key program using the naming convention $CTL-num where num is the CTL value. Remember in your hot key program not to disturb the environment (i.e., do not close any files that are already open, but close any files you open in this program and remove any windows you create).

For example, the keystroke Ctrl -A returns $01$, which is defined in MY_START_UP program as a hot key:

1000 DEFCTL $01$=-500

ProvideX will call $CTL-500 whenever anyone hits the hot key Ctrl -A throughout the current session.