*IOCANCELCHAR (SETMODE)

9.6A

*IOCANCELCHAR={char}

This control changes the default IO cancel character to be used for aborting a FILE, AFILE, or IFILE READ instruction. This keyword only changes the IO cancel character setting for the current program and load modules in use.

After the *IOCANCELCHAR is changed, the new setting takes affect when the file variable is re-opened or prepared. A change does not affect any variables that are already opened or prepared.

The {char} is a Character String Variable or a Literal. The Character String Variable or Literal contains a single character value or it contains a character sequence defined as follows:

ESC, ESCAPE,

F1, F2, F3, F4, F5, F6, F7, F8, F9, F10

F11, F12, F13, F14, F15, F16, F17, F18, F19, F20

F21, F22, F23, F24, F25, F26, F27, F28, F29, F30

F31, F32, F33, F34, F35, F36, F37, F38, F39, F40

UP, DOWN, LEFT, RIGHT,

INS, INSERT, DEL, DELETE,

HOME, PGUP, PAGEUP, PGDN, PAGEDOWN, END

This keyword replaces the *AAMCANCELCHAR key that is now obsolete.

Examples:

MyChar INIT "x"

MyCharEsc INIT "Escape"